Quickstart

Use Mermaid Diagrams for Confluence to quickly create and edit text-based diagrams inside Confluence pages. This guide shows how to insert, edit, and publish a diagram.

Insert a Diagram

1. Open a Confluence page in Page edit mode.

2. Start typing /mermaid-cloud and select the Mermaid Diagrams for Confluence macro from the menu.

3. A Mermaid editor panel will appear.

4. Enter Mermaid diagram text into the editor.

5. Click Publish.

You will be prompted to enter a name for the diagram. After naming it, the diagram will be added to the page as a placeholder.

Edit a Diagram

1. In Page edit mode, click the diagram.

2. Select Edit from the menu above the diagram.

3. The Mermaid editor panel will open with the existing source text.

4. Modify the diagram text and click Update.

The diagram preview will refresh after updating.
For advanced formatting and syntax options, refer to the official Mermaid documentation: https://mermaid.js.org/intro/

Publish the Page

1. After inserting or editing diagrams, click Publish in the top-right corner of the page.

2. Diagrams will render in the published page the same way they appear in edit mode.

3. Viewers can zoom or pan diagrams if needed.

Your diagram is now part of the page content and remains editable on future page edits.