Diagram Macros for Confluence · Guide
Markdown in Confluence Cloud pages
The Confluence Cloud editor understands some Markdown as you type: a # at the start of a line becomes a heading and three backticks start a code block. It does not keep Markdown as Markdown. Once converted, the page holds rich text, and there is no built-in block where you paste Markdown and edit it as text later. A Markdown macro adds that.
When Markdown source matters
Keeping the Markdown is useful when the text comes from somewhere else and goes back there: a README from a Git repository, release notes written by a script, or a document your engineers already write in Markdown. With a macro, you paste the same text, and you can copy it out again unchanged.
Step by step with Diagram Macros
- Install Diagram Macros for Confluence from the Marketplace listing. It contains two macros, Mermaid diagram and Markdown.
- Insert the macro. Edit a page and type
/Markdown, or pick Markdown from the + menu. - Paste or write Markdown on the left. The preview on the right shows how it will look on the page.
- Save and publish. Press Save, then publish the page. Select the macro and click the pencil to edit the text later.

What the Markdown macro supports
- CommonMark, the standard Markdown syntax, plus tables and automatic links.
- Headings, lists, block quotes, code blocks, links and emphasis.
- Raw HTML is shown as text and never rendered, so pasted text cannot run scripts or change the page.
- Links open in a new tab. Image syntax becomes a link to the image instead of loading it from another server.
- PDF and Word exports turn the Markdown into normal Confluence content: headings, lists, tables and code.
- The text is stored in the page and indexed by Confluence search. One macro holds up to 50,000 characters.
The same app also draws Mermaid diagrams. See How to add Mermaid diagrams in Confluence Cloud.
Price
Free for up to 10 users. From 11 users it costs 0.30 USD per user per month, billed by Atlassian. The Pricing tab on the listing shows the exact figure for your user tier, and you can try the app free for 30 days before you pay.
Get Diagram Macros for Confluence on the Atlassian Marketplace
