When pasting content into Confluence that includes fenced Mermaid code blocks, they should automatically render as diagrams. Currently there's no way to get Mermaid diagrams into a page without manually inserting the macro through the editor UI. This means tools like AI code assistants that generate documentation with inline Mermaid syntax can't produce ready-to-go Confluence content — every diagram requires manual intervention after pasting.
Welcome to the community !!
That certainly is a a limitation as Confluence cannot recognize different types of diagramming code. There is PlantUML as well and few more.
I understand that you may already have a Mermaid Diagram tool on your Confluence instance.
If you would still like to explore an alternative, do try out
Mermaid Diagrams & Charts for Confluence
The app has more than 15 diagramming templates and also integrates with your code repositories like GitHub/Bitbucket.
Disclaimer : I am part of the app dev team
There's a structural reason this doesn't work today: the paste pipeline converts a fixed set of patterns (links, tables, lists...) but diagrams in Confluence are macros in the page's storage format — and there's no hook that recognizes ```mermaid fences on paste and inserts a macro for you. That's why every diagram needs a manual step somewhere.
Two ways to close that gap, depending on how AI-generated content flows into your pages:
Full Markdown documents (the typical AI-assistant output with ```mermaid blocks inline): the Enhanced Markdown for Confluence macro gives you a Markdown editor with a live split preview that renders Mermaid and ZenUML fences as diagrams. Paste the whole document or upload the .md file — fenced diagrams render with everything else, so "AI output → Confluence page" becomes one paste instead of one rebuild per diagram.
Individual diagrams on an otherwise-native page: type /mermaid and use Mermaid Plus for Confluence — paste your code straight in, watch the live preview while you edit, 29 diagram types. The macro step still exists, but the code goes from your AI tool into the editor without reformatting.
— Simon from NGPILOT
You must be a registered user to add a comment. If you've already registered, sign in. Otherwise, register and sign in.
Confluence has no built-in way to auto-detect fenced Mermaid and render it on paste. Every diagramming format still needs its macro inserted manually in the editor.
For AI-generated content, our app Just Add+ renders Mermaid from inline text, a page attachment, or a raw GitHub or GitLab URL.
You paste the Mermaid block straight into the Diagram macro and it renders, no rebuild step.
Feel free to reach out if you'd like to learn more.
You must be a registered user to add a comment. If you've already registered, sign in. Otherwise, register and sign in.
Mermaid actually has a Confluence (and Jira) application you can install from the marketplace that helps you add Mermaid diagrams to pages and work items.
If you need help their support is fantastic also.
Make sure you only download the app that is made by Mermaid, there are several out there, but use the official Mermaid ones.
You must be a registered user to add a comment. If you've already registered, sign in. Otherwise, register and sign in.
You must be a registered user to add a comment. If you've already registered, sign in. Otherwise, register and sign in.