Mermaid diagrams in Confluence — no plugin required
Confluence does not render Mermaid fences on its own. The lightest fix is an image embed: beautify the diagram, save it, and paste its SVG URL into any page. No marketplace app, no admin ticket — and the image stays current when the diagram changes.
Step-by-step
Paste your Mermaid or PlantUML source into the editor and click beautify. Pick a theme that matches your Confluence space — the exported image is exactly what the preview shows.
Saving the diagram gives it a stable image URL of the form api.beauty-diagram.com/v1/share/<token>.svg — a plain SVG served over HTTP, no scripts.
In the Confluence editor, insert an image and paste the URL. The diagram renders inline like any other image — readers need no plugin and admins approve nothing.
The embed re-fetches on load, so updating the diagram in the editor updates every Confluence page that embeds it within a few minutes — no re-uploading attachments.
Tips
A screenshot is stale the day the flow changes. A saved embed is one source of truth — fix the diagram once and every page showing it updates.
If your admin will install one, Confluence marketplace Mermaid apps render fences inside the page editor itself. The embed route is for when you want no installs, or output that looks presentation-ready rather than default-rendered.
Light spaces read best with light themes; export a PNG fallback and attach it if your space is exported to PDF regularly, since PDF export snapshots images.
Frequently asked questions
Does Confluence render Mermaid diagrams natively?
No. Out of the box, a ```mermaid code fence in Confluence stays plain text. You either install a marketplace app that renders fences, or embed the diagram as an image — the route this guide covers needs no app and no admin approval.
How do I embed a Mermaid diagram in Confluence without a plugin?
Render it to a hosted SVG and insert that URL as an image. Beautify your source in the editor, save, copy the share image URL, then use Confluence's insert-image-by-URL. The diagram renders inline and stays current when you edit the source.
Will the embedded diagram update when I change it?
Yes. The share URL serves the latest saved version with a short cache, so edits propagate to every embedding page within a few minutes — unlike attached screenshots, which stay frozen.
Can I use this on a Confluence page my whole team edits?
Yes — the embed is just an image URL in the page, so anyone can move or resize it like any image. Keep edit access to the diagram source in the editor, where changes are versioned by your account.
Is the embedded image free to serve?
Yes. Free-plan embeds carry a small watermark; paid plans remove it. The URL serves plain SVG over HTTP with no scripts, which is why Confluence accepts it as a regular image.