Import & Export

Excalidraw for Confluence supports importing existing diagram files and exporting your diagrams in multiple formats. All import and export options are available inside the diagram editor.

Importing Diagrams

Import an .excalidraw File

If you have an existing diagram created in Excalidraw or any other Excalidraw-compatible tool, you can import it directly:

1. Open the diagram editor by clicking Edit on the macro (or inserting a new macro).
2. In the Excalidraw editor, open the hamburger menu (☰) in the top-left corner.
3. Select Open and choose your .excalidraw file from your local machine.
4. The diagram is loaded into the editor. Make any adjustments and click Save.

tip

Importing a file replaces the current diagram content. Make sure to export the existing diagram first if you want to keep it.

Exporting Diagrams

All export options are available from inside the Excalidraw editor.

Export as PNG

1. Open the diagram editor.
2. Open the hamburger menu (☰) → Export image.
3. Select PNG and click Export.
4. The PNG image is downloaded to your local machine.

Export as SVG

1. Open the diagram editor.
2. Open the hamburger menu (☰) → Export image.
3. Select SVG and click Export.
4. The SVG file is downloaded to your local machine.

SVG exports are resolution-independent and ideal for use in presentations, web pages, or high-quality print documents.

Export as .excalidraw

To save the raw diagram file for backup, sharing, or use in another Excalidraw environment:

1. Open the diagram editor.
2. Open the hamburger menu (☰) → Save to disk.
3. The .excalidraw file is downloaded to your local machine.

PDF and Word Export

When you use Confluence's built-in Export to PDF or Export to Word feature on a page that contains an Excalidraw macro, the diagram is automatically rendered and included in the exported document as an image.

No additional steps are required. This works with Confluence's standard export functionality.

Custom Libraries

You can upload your own .excalidrawlib library files to reuse custom shapes, icons, and component sets across your diagrams.

Add a Custom Library

1. Open the diagram editor.
2. Click the library icon (book icon) in the left toolbar.
3. Click the ••• menu inside the library panel and select Open library file.
4. Choose your .excalidrawlib file from your local machine.
5. Your custom shapes are now available in the library panel for this diagram.

info

Libraries are stored per diagram. A library added to one macro will not automatically appear in other macros on other pages.

Create Your Own Library

You can build a personal library from shapes you frequently reuse:

1. Select one or more elements on the canvas.
2. Click Add to library in the toolbar that appears.
3. The shapes are saved to your library for the current diagram session.

To export your library for reuse elsewhere:

1. Open the library panel.
2. Click ••• → Export library.
3. Save the .excalidrawlib file for later import.