Aldorock apps for Atlassian

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

  1. Install Diagram Macros for Confluence from the Marketplace listing. It contains two macros, Mermaid diagram and Markdown.
  2. Insert the macro. Edit a page and type /Markdown, or pick Markdown from the + menu.
  3. Paste or write Markdown on the left. The preview on the right shows how it will look on the page.
  4. Save and publish. Press Save, then publish the page. Select the macro and click the pencil to edit the text later.

A Confluence page with a checklist written in Markdown and rendered by the Markdown macro, including a table

What the Markdown macro supports

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

More guides