Forums

Articles
Create
cancel
Showing results for 
Search instead for 
Did you mean: 

Auto-convert pasted Mermaid code blocks into rendered diagrams

Shelley Emma Criveano
I'm New Here
I'm New Here
Those new to the Atlassian Community have posted less than three times. Give them a warm welcome!
June 16, 2026

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.

4 answers

1 vote
Rahul_RVS
Atlassian Partner
June 16, 2026

Hi @Shelley Emma Criveano 

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

Mermaid Diagrams.pngMermaid Diagrams Templates.pngMermaid Diagrams GIT.png

0 votes
Simon_NGPILOT_
Atlassian Partner
September 1, 2026

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

0 votes
Igor Medeiros - Modus Create
Atlassian Partner
June 17, 2026

Hi @Shelley Emma Criveano

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.

0 votes
Jason Krewson
Rising Star
Rising Star
Rising Stars are recognized for providing high-quality answers to other users. Rising Stars receive a certificate of achievement and are on the path to becoming Community Champions.
June 16, 2026

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.

Suggest an answer

Log in or Sign up to answer
DEPLOYMENT TYPE
CLOUD
PRODUCT PLAN
ENTERPRISE
TAGS
AUG Leaders

Atlassian Community Events