Forums

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

Copy markdown code into confluence with embedded mermaid code

Andreas Walden
May 21, 2026

Installed plugin: https://marketplace.atlassian.com/apps/1232887/mermaid-diagrams-viewer

 

Insert markdown text with embedded mermaid code with extended copy

image.png

Copy the code as markdown

image.png

Expected: Add the mermaid code as a code block and then render the mermaid code.

 

image.png

 

Got: 

image.png

 

 

2 answers

0 votes
Simon_NGPILOT_
Atlassian Partner
May 28, 2026

You've hit a real limitation — Confluence's Markdown import and Mermaid rendering are handled by separate systems, and they don't communicate with each other. The `/mermaid` macro works on its own, but when you paste Markdown containing Mermaid code blocks, the Markdown importer treats the code blocks as plain text and doesn't trigger the Mermaid renderer.

This is a known gap. The `/mermaid` command and Markdown import each work individually, but there's no built-in way to make Mermaid render inside pasted Markdown content.

One approach that solves this: Enhanced Markdown for Confluence (full disclosure, I work for NGPILOT, the vendor behind it) has a WYSIWYG Markdown editor that can render Mermaid diagrams embedded directly within Markdown content. So you can write or paste Markdown with Mermaid code blocks, and the diagrams render inline without needing a separate `/mermaid` macro.


It also supports live preview, so you see both the Markdown and the rendered result (including diagrams) before saving.

— Simon from NGPILOT
Andreas Walden
June 1, 2026

Hi Simon,

thanks for the info, I will check it out

 

Regards,

Andreas

0 votes
Tomislav Tobijas
Community Champion
May 22, 2026

Hey @Andreas Walden ,

I've only seen this app once, but haven't tested it. You could check their official docs or use Atlassian Labs (GitHub) official support channel

Now, have you maybe tried using the following command/macro

/mermaid

This might open/display something like "Mermaid Diagrams for Confluence" 👀

Cheers,
Tobi

Andreas Walden
May 22, 2026

Hi Tobi,

 

thanks for the answer. Yes, the /mermaid works if I edit it directly in confluence. But how should I add this command inside the markdown text? 

The mermaid plugin works perfect. Also the markdown import. But they do not work together. 

 

I will try the support channel.

 

Regards,

Andreas

Like Tomislav Tobijas likes this
Tomislav Tobijas
Community Champion
May 28, 2026

@Andreas Walden I'm OOO, but I could play around with this next week and see how it actually works.

But if you find the answer in the meantime, I would appreciate it if you could share it here 👀

Suggest an answer

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

Atlassian Community Events