# Does Confluence Support Mermaid? Setup Guide & Diagram Types May 6, 2026 · 4 min read [NGPilot](https://ngpilot.com) No, Confluence does not support Mermaid diagrams natively. There is no built-in macro or feature that renders Mermaid syntax in Confluence pages. To add Mermaid diagrams to Confluence, you need a Marketplace app. This guide covers how to set up Mermaid in Confluence and which diagram types you can create. ## How to add Mermaid to Confluence[​](#how-to-add-mermaid-to-confluence "Direct link to How to add Mermaid to Confluence") [Mermaid Plus for Confluence](https://marketplace.atlassian.com/apps/1236814/mermaid-plus-for-confluence?hosting=cloud\&tab=overview) adds a full Mermaid diagram editor to Confluence. It supports 29 diagram types with a live preview, built-in templates, and multiple themes. ### Installation[​](#installation "Direct link to Installation") 1. Go to [Mermaid Plus for Confluence](https://marketplace.atlassian.com/apps/1236814/mermaid-plus-for-confluence?hosting=cloud\&tab=overview) on the Atlassian Marketplace 2. Click **Get it now** — the app installs into your Confluence Cloud instance 3. Mermaid Plus is free for up to 10 users ### Creating your first diagram[​](#creating-your-first-diagram "Direct link to Creating your first diagram") 1. Open a Confluence page in edit mode 2. Type `/mermaid` and select **Mermaid Plus** from the macro dropdown 3. The macro opens a split-pane editor with a code editor on the left and live preview on the right 4. Paste or write your Mermaid syntax — the preview updates in real time 5. Click **Save** on the macro, then publish the page ## Mermaid diagram types supported in Confluence[​](#mermaid-diagram-types-supported-in-confluence "Direct link to Mermaid diagram types supported in Confluence") Mermaid Plus supports 29 diagram types. Here are the most popular ones: ### Flowcharts[​](#flowcharts "Direct link to Flowcharts") ``` flowchart TD A[Start] --> B{Decision} B -->|Yes| C[Action 1] B -->|No| D[Action 2] C --> E[End] D --> E ``` Read the full tutorial: [Create flowcharts in Confluence](/blog/create-flowcharts-confluence.md). ### Sequence diagrams[​](#sequence-diagrams "Direct link to Sequence diagrams") ``` sequenceDiagram Client->>API: POST /login API->>Auth: Validate credentials Auth-->>API: Token API-->>Client: 200 OK + Token ``` ### Class diagrams[​](#class-diagrams "Direct link to Class diagrams") ``` classDiagram class User { +String name +String email +login() } class Order { +Date created +Float total +checkout() } User --> Order : places ``` ### ER diagrams[​](#er-diagrams "Direct link to ER diagrams") ``` erDiagram CUSTOMER ||--o{ ORDER : places ORDER ||--|{ LINE-ITEM : contains CUSTOMER { string name string email } ORDER { date created float total } ``` ### Gantt charts[​](#gantt-charts "Direct link to Gantt charts") ``` gantt title Project Timeline section Phase 1 Research :a1, 2026-01-01, 30d Design :a2, after a1, 20d section Phase 2 Development :a3, after a2, 45d Testing :a4, after a3, 15d ``` ### Mindmaps[​](#mindmaps "Direct link to Mindmaps") ``` mindmap root((Confluence)) Diagrams Flowcharts Sequence Class Documents Markdown Code Blocks ``` ### More diagram types[​](#more-diagram-types "Direct link to More diagram types") | Category | Diagram Types | | ---------- | ------------------------------------- | | Structured | Flowchart, Sequence, Class, State, ER | | Planning | Gantt, Timeline, Requirement | | Charts | Pie, XYChart, Blockbench | | Visual | Mindmap, Quadrant | | Technical | GitGraph, C4, Architecture | | Other | Journey, Sankey,radar | See all 29 types: [Mermaid diagram types FAQ](/blog/faq-mermaid-diagram-types-confluence.md). ## Mermaid Plus features[​](#mermaid-plus-features "Direct link to Mermaid Plus features") * **Live preview** — see your diagram render as you type * **Template library** — one-click templates for every diagram type * **Multiple themes** — default, dark, forest, neutral * **Export** — download diagrams as PNG or SVG * **Auto-resize** — diagrams scale to fit the page width ## Alternatives to Mermaid in Confluence[​](#alternatives-to-mermaid-in-confluence "Direct link to Alternatives to Mermaid in Confluence") | App | Input Method | Best For | | ---------------------------------------------------------------------------------------------------------------------------------------- | --------------------- | ---------------------------------- | | [Mermaid Plus](https://marketplace.atlassian.com/apps/1236814/mermaid-plus-for-confluence?hosting=cloud\&tab=overview) | Text (Mermaid syntax) | Structured diagrams, documentation | | [Excalidraw Plus](https://marketplace.atlassian.com/apps/1237651/excalidraw-plus-whiteboards-for-confluence?hosting=cloud\&tab=overview) | Visual (drag & drop) | Freeform drawing, wireframes | | [Graphviz Charts](https://marketplace.atlassian.com/apps/1237659/graphviz-charts-for-confluence?hosting=cloud\&tab=overview) | Text (DOT language) | Network graphs, dependency trees | Read the full comparison: [Confluence diagram tools compared](/blog/confluence-diagram-tools-comparison.md). ## Related resources[​](#related-resources "Direct link to Related resources") * [Mermaid Plus — marketplace](https://marketplace.atlassian.com/apps/1236814/mermaid-plus-for-confluence?hosting=cloud\&tab=overview) | [documentation](/apps/mermaid-plus-for-confluence.md) * [Create Mermaid diagrams in Confluence](/blog/create-mermaid-diagrams-confluence.md) * [Mermaid troubleshooting FAQ](/blog/faq-mermaid-troubleshooting.md) * [Mermaid syntax cheat sheet](/blog/faq-mermaid-syntax-cheat-sheet-confluence.md) * [Confluence diagram tools comparison](/blog/confluence-diagram-tools-comparison.md) * [Best Confluence apps for developers](/blog/best-confluence-apps-developers.md) Try Mermaid Plus for Confluence All 26 Mermaid diagram types with live preview and one-click templates — free for up to 10 users. [Get it on the Atlassian Marketplace](https://marketplace.atlassian.com/apps/1236814/mermaid-plus-diagrams-for-confluence?utm_source=ngpilot.com\&utm_medium=website\&utm_campaign=mermaid-plus-for-confluence) ## Related guides * [How to Create Mermaid Diagrams in Jira](/blog/how-to-create-mermaid-diagrams-jira.md) * [Export Jira Issues to Excel or CSV](/blog/export-jira-issues-to-excel.md) * [Bulk Download Jira Attachments](/blog/bulk-download-jira-attachments.md) * [How to Migrate Confluence Content](/blog/how-to-migrate-confluence-content.md) Explore NGPILOT[Browse Solutions](/solutions.md)[All Apps](/apps.md)[Atlassian Marketplace →](https://marketplace.atlassian.com/vendors/1226848/?utm_source=ngpilot.com\&utm_medium=blog\&utm_campaign=hub-links) **Tags:** * [confluence](/blog/tags/confluence.md) * [mermaid](/blog/tags/mermaid.md) * [diagrams](/blog/tags/diagrams.md) * [flowcharts](/blog/tags/flowcharts.md) * [sequence-diagram](/blog/tags/sequence-diagram.md) * [gantt](/blog/tags/gantt.md) * [mindmap](/blog/tags/mindmap.md)