Mermaid Macros for Confluence
Insert a Mermaid Diagram macro to render flowcharts, sequence diagrams, ERDs, and more inline on any Confluence page.
- Zero scopes
- Runs on Atlassian
- Live-preview editor
- Free ≤ 10 users
Overview
A companion app to Mermaid Diagrams for Jira, built for Confluence. It adds a Mermaid Diagram macro with a live-preview editor: write or paste Mermaid source with syntax highlighting and watch the diagram render as you type. Diagrams render in the browser and appear in PDF page exports. No external services and no setup.
Features
- Adds a Mermaid Diagram macro you insert via /Mermaid in the page editor
- Live-preview editor with syntax highlighting, starter templates, and errors that point at the offending line
- Diagrams render in PDF page exports; Word exports include the diagram source
- Renders flowcharts, sequence diagrams, ERDs, Gantt charts, state diagrams, mindmaps, and more
- Display options per macro: diagram, source code, or both
- Export or copy any diagram as SVG or PNG
- Zero data-access permissions; the app requests no scopes at all
- Runs on Atlassian with in-browser rendering; the app makes no external calls
- Import diagrams from mermaid.live: paste a share link into the editor and the source is extracted automatically
- Pro styling: nine designed styles saved with the macro, plus right-angle connectors
- Version 3 free forever; v4 is a subscription: $0 for teams of 10 or under, Pro styling included
Frequently Asked Questions
How do I insert a diagram on a Confluence page?
In the page editor, type /Mermaid to insert the Mermaid Diagram macro, then write or paste your Mermaid source in the editor, which has syntax highlighting and a live preview that renders as you type. Save, and the diagram renders inline as an interactive SVG.
I pasted a mermaid code block. Why doesn't it render?
A plain mermaid code block stays plain text in Confluence. The app never scans your page content, which is exactly why it can run with zero permissions. Insert the Mermaid Diagram macro instead (type /Mermaid in the editor) and paste your source there.
Do diagrams appear when I export a page to PDF or Word?
Yes. PDF exports include your diagrams fully rendered, with no app controls in the output. Word exports include the diagram source as a readable code block.
What permissions does the app request?
None. The app requests zero data-access scopes, so it cannot read or modify anything in your Confluence instance beyond rendering the macro you insert.
Does my diagram source leave Confluence?
No. Rendering happens 100% client-side in your browser using the Mermaid library, and the app never communicates with any service outside Atlassian: no analytics, no tracking. Your diagram source stays in Confluence unless you deliberately take it out, for example by exporting an image to your device.
Can I export diagrams?
Yes. Any rendered diagram can be exported or copied as SVG or PNG.
How much does it cost?
Version 3 is free forever, for teams of any size; sites that stay on v3 keep everything they have. Updating to v4 starts a subscription: $0 for teams of 10 or under, paid above that, with Pro styling included and no core feature moved behind it. Current pricing is on the app’s Atlassian Marketplace pricing tab.
Further Reading
Try Mermaid Macros for Confluence today
Built on Atlassian Forge, it runs entirely on Atlassian's cloud with no external servers and no data egress.