Features and how to

Markdown Macro+ gives you two ways to write Markdown in Confluence Cloud:

• The macro keeps Markdown inside the page. You write it with a live preview, and the page renders it. The source stays editable as Markdown.
• Edit with Markdown turns a whole page into Markdown and back. You edit the page as Markdown, and it publishes as normal Confluence content.

The macro

• The macro editor: toolbar, live preview, resizable panes, .md import and download
• Markdown syntax: GitHub-flavoured Markdown, callouts, table of contents, emoji and images
• Code blocks: syntax highlighting and a copy button
• Math: KaTeX, inline and block
• Mermaid diagrams: flowcharts, sequence diagrams and more
• Attachments: images and files from this page or the whole site

Pages in Markdown

• Edit with Markdown: edit a page or blog post as Markdown, with drafts, version notes and conflict checks
• New page from Markdown: write a new child page in Markdown

For everyone

• Templates and variables: reusable starting points with {{date}}, {{user.name}} and more
• Search and export: macro content in Confluence search and PDF or Word exports
• Admin guide: permissions, templates and approving updates

Which one to use

	The macro	Edit with Markdown
Content is stored as	Markdown, inside the macro	Native Confluence content
Math, Mermaid and [[toc]]	Yes	Inside a Markdown Macro+ block
Panels, expands, status and dates	Callouts as panels	Yes
Other people can edit it in	The macro editor	The Confluence editor or Edit with Markdown
Best for	READMEs, runbooks, technical notes kept as Markdown	Writing or reworking whole pages in Markdown