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
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 — in-browser rendering; your diagram source never leaves Confluence
- Import diagrams from mermaid.live — paste a share link into the editor and the source is extracted automatically
- Free — no charge
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 — it 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 — 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. The app never communicates with any service outside Atlassian — no analytics, no tracking, and nothing leaves your Confluence instance.
Can I export diagrams?
Yes — any rendered diagram can be exported or copied as SVG or PNG.
How much does it cost?
Nothing — the app is free on the Atlassian Marketplace.
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.