Skip to main content

Does Confluence Support Mermaid? Setup Guide & Diagram Types

· 4 min read
NGPilot
NGPilot
NGPilot

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​

Mermaid Plus for Confluence adds a full Mermaid diagram editor to Confluence. It supports 26+ diagram types with a live preview, built-in templates, and multiple themes.

Installation​

  1. Go to Mermaid Plus for Confluence 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​

  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 Plus supports 26+ diagram types. Here are the most popular ones:

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.

Sequence diagrams​

sequenceDiagram
    Client->>API: POST /login
    API->>Auth: Validate credentials
    Auth-->>API: Token
    API-->>Client: 200 OK + Token

Class diagrams​

classDiagram
    class User {
        +String name
        +String email
        +login()
    }
    class Order {
        +Date created
        +Float total
        +checkout()
    }
    User --> Order : places

ER diagrams​

erDiagram
    CUSTOMER ||--o{ ORDER : places
    ORDER ||--|{ LINE-ITEM : contains
    CUSTOMER {
        string name
        string email
    }
    ORDER {
        date created
        float total
    }

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​

mindmap
  root((Confluence))
    Diagrams
      Flowcharts
      Sequence
      Class
    Documents
      Markdown
      Code Blocks

More diagram types​

CategoryDiagram Types
StructuredFlowchart, Sequence, Class, State, ER
PlanningGantt, Timeline, Requirement
ChartsPie, XYChart, Blockbench
VisualMindmap, Quadrant
TechnicalGitGraph, C4, Architecture
OtherJourney, Sankey,radar

See all 26+ types: Mermaid diagram types FAQ.

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​

AppInput MethodBest For
Mermaid PlusText (Mermaid syntax)Structured diagrams, documentation
Excalidraw PlusVisual (drag & drop)Freeform drawing, wireframes
Graphviz ChartsText (DOT language)Network graphs, dependency trees

Read the full comparison: Confluence diagram tools compared.