Markdown Macro

The Markdown Macro lets you author your Confluence page using Markdown syntax. Your Markdown content will seamlessly appear on your Confluence page as if you had written it using Confluence’s editor.

To use this macro:

Type /markdown in your Confluence page.
Choose the “Markdown” option.
Pick which of the sources of Markdown you want to embed. We support direct entry, a file attached to the Confluence page, or a Remote URL.

Click the refresh icon next to the word Preview to see a preview of your content

Mermaid Support

The Markdown Macro supports Mermaid diagrams, allowing you to create flowcharts, sequence diagrams, and more.

To ensure proper rendering, Mermaid code must be placed inside fenced code blocks using triple backticks and specifying mermaid as the language, like this:

```mermaid
graph TD
    A[Start] --> B{Is it working?}
    B -- Yes --> C[Continue]
    B -- No --> D[Fix it]
```

This formatting ensures that the Markdown Macro correctly identifies and renders the Mermaid diagram.

Remote URL Support

We support embedding Markdown from the following sources:

Any public URL
Private Github Cloud Repositories
Private Bitbucket Cloud Repositories
Private GitLab Cloud Repositories

For private repository sources, we will ask the user who is viewing the Confluence page to oauth to the repository to ensure they have access to the file.