Skip to main content

Getting Started

Prerequisites​

  • Confluence Cloud instance
  • Confluence Administrator permissions to install apps from the Atlassian Marketplace

Install the App​

info

The Atlassian Marketplace listing will be linked here once the app is published.

To install:

  1. Go to Settings → Apps → Find new apps.
  2. Search for Excalidraw.
  3. Click Try it free and follow the prompts.
  4. Once installed, the Excalidraw Diagram macro is immediately available on all Confluence pages — no additional configuration required.

Create Your First Diagram​

  1. Open or create a Confluence page in edit mode.
  2. Click the Insert (+) button in the editor toolbar and search for Excalidraw Diagram.
  3. Select the macro — the Excalidraw editor opens inside the page.
  4. Draw your diagram using the toolbar on the left (shapes, arrows, text, free-hand, and more).
  5. When finished, click Save to close the editor and embed the diagram into the page.
  6. Publish the page — the diagram is now visible to all users with page access.

View and Edit an Existing Diagram​

  • Viewing: Anyone with access to the Confluence page can see the rendered diagram. The viewer includes zoom controls so readers can inspect the diagram in detail.
  • Editing: Users with edit permissions for the page can click the Edit button on the macro to reopen the Excalidraw editor and make changes. Save the diagram and republish the page to apply updates.

Export a Page with Diagrams to PDF​

Excalidraw diagrams are automatically included when you export a Confluence page using Confluence's built-in export:

  1. Open the page and click the ••• (More actions) menu.
  2. Select Export → Export to PDF (or Export to Word).
  3. The exported file will contain the diagram rendered as an image.

No extra steps are required — the export works out of the box.

Next Steps​