Easy Tech TutsHow to Use Mermaid Diagrams in Confluence Easily 2026
By Impran M N
Static image uploads break the moment your architecture changes, forcing constant re-exports from separate design tools. This guide shows how to write live, text-based Mermaid diagrams directly inside a Confluence code block in 2026.
01Open a code block
In edit mode, type `/code` to deploy a text frame and select Mermaid from the language dropdown.
02Set the chart direction
Type `graph TD` to set a top-down direction, then write out your system nodes and text labels.
03Connect your nodes
Use arrow connectors to link individual step IDs together into a clean relational flow.
04Preview the render
Click the macro's display tab to toggle between raw code view and the live rendered preview.
05Adjust theme and publish
Tweak alignment in the bottom toolbar, switch the visual theme if needed, then hit Publish.
Frequently asked questions
Do I need a marketplace plugin to use Mermaid diagrams in Confluence?
Native code blocks support Mermaid syntax directly, though plugins like Mermaid Chart can add extra editing features.
Will my diagram update automatically if I change the code?
Yes, editing the Mermaid text and republishing updates the rendered graph without needing to redraw anything manually.
Can I change the color theme of my diagram?
Yes, macro switches let you instantly transform a chart into dark mode, forest tones, or custom brand colors.
Can Mermaid handle complex diagrams like sequence flows or database structures?
Yes, Mermaid syntax supports sequence timelines, database structures, and microservice relationship maps.
Watch the full walkthrough
The same steps, demonstrated on screen from start to finish.
