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.

3 answers

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
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
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