Confluence Cloud app · Markdown · Mermaid · Code
Markreef: Markdown, Mermaid diagrams and code for Confluence
Coming soonFree to 10 users (planned)Runs on AtlassianMarkreef is a Confluence Cloud app that lets you write GitHub-flavoured Markdown (tables, task lists, footnotes), Mermaid diagrams and syntax-highlighted code in one macro, with a live side-by-side preview. It runs entirely on Atlassian Forge: no external servers, no sign-in, nothing leaves your site, and PDF and Word exports keep the content. It is not yet on the Atlassian Marketplace.
Not yet on the Atlassian Marketplace. This page will link to the listing when it is live.
- Platform
- Confluence Cloud (Atlassian Forge app, "Runs on Atlassian" eligible)
- Status
- Built and tested; not yet listed on the Atlassian Marketplace
- Markdown
- CommonMark + GitHub extensions: tables, task lists, strikethrough, autolinks, footnotes, heading anchors; safe raw HTML such as <details> and <kbd>
- Diagrams
- Mermaid 12, strict security mode, light/dark/auto theme, SVG and PNG export
- Code
- About 60 languages, optional line numbers, copy button
- Security
- DOMPurify sanitising; no scopes, no storage, no egress
- Limits
- External images shown as links; 100,000 characters per macro
Who it is for
Engineering, platform and SRE teams who keep READMEs, runbooks and architecture decision records in Markdown and want them in Confluence without rewriting, and anyone who wants diagrams-as-code in Confluence with a single app instead of two.
What it does
- Paste the README, runbook or ADR you already have; tables, task lists, footnotes and fenced code render the way GitHub shows them.
- Write Mermaid in the same macro, with "Insert example" for each diagram type.
- See the result as you type in a side-by-side editor.
- Export pages to PDF and Word with headings, lists, tables and code intact.
Quick start
- On a Confluence page, type
/markreef(or find "Markreef" in the macro browser). - Write or paste Markdown on the left and watch the preview on the right. Use "Insert example" for diagrams, tables, task lists or code.
- Choose a theme (Auto, Light or Dark), line numbers, copy button and diagram export, then click Save.
Example macro content:
## Deploy runbook
- [x] Tag the release
- [ ] Run the migration
```mermaid
sequenceDiagram
Dev->>CI: push tag
CI->>Prod: deploy
Prod-->>Dev: health check OK
```
```bash
kubectl rollout status deploy/api
```Pricing
Planned pricing, not yet on sale. Free for teams of up to 10 users. Larger teams get a 30-day trial. Billed by Atlassian ("Paid via Atlassian").
| Users | Price per user per month |
|---|---|
| Up to 10 | Free |
| 11–100 | $0.30 |
| 101–250 | $0.22 |
| 251–1,000 | $0.14 |
| 1,001–2,500 | $0.08 |
How it compares
| App | Vendor | Cloud installs | Rating | 100 users | Covers |
|---|---|---|---|---|---|
| Markreef (this) | Tidewell Software | Not listed yet | – | Planned $0.30 | Markdown + Mermaid + code, one macro, live preview |
| Just Add+ Embed Markdown, Diagrams & Code | Modus Create | 7,921 | 4.3★ (50) | $0.50 | Markdown, diagrams and code, mainly sourced from Git |
| Mermaid diagrams viewer | Atlassian Labs | 7,782 | 3.0★ (26) | Free | Mermaid |
| Mermaid Diagrams for Confluence | Stratus Add-ons | 6,163 | 4.0★ (23) | $0.40 | Mermaid |
| Mermaid Chart for Confluence | Mermaid Chart | 4,077 | 2.8★ (20) | Free | Mermaid |
| Render Markdown | – | 3,842 | 3.5★ (26) | Free | Markdown |
| Markdown for Confluence | Appfire | 2,222 | 3.5★ (16) | $1.34 | Markdown |
| Mermaid Charts & Diagrams for Confluence | weweave | 2,156 | 4.6★ (15) | $0.23 | Mermaid; cheaper than us and well rated |
If you only need Mermaid, weweave's app is cheaper and well rated; if your Markdown lives in Git, Just Add+ pulls it from there. Longer write-up: Markdown and Mermaid apps for Confluence compared.
Frequently asked questions
How do I add Markdown to a Confluence Cloud page?
With Markreef, type /markreef on a page (or find it in the macro browser), paste or write Markdown on the left and watch the preview on the right, then save.
Which Mermaid diagrams are supported?
Flowchart, sequence, Gantt, class, ER, state, pie, mind map, git graph and more, using Mermaid 12 in strict security mode. A syntax error shows a readable error box and the rest of the page still renders.
Does it work in dark mode?
Yes. Diagrams follow Confluence's theme automatically, or you can pin light or dark.
Can I export diagrams?
Yes, as SVG or as a 2x PNG. PDF and Word page exports carry headings, lists, tables, links and code; diagrams export as their Mermaid source.
Does any data leave my Confluence site?
No. Markreef requests no product scopes, stores nothing and makes no external requests. All libraries are bundled. Images hosted outside Atlassian are shown as a link instead of loaded.
Which code languages are highlighted?
About 60 via highlight.js, including JavaScript, TypeScript, Python, Java, Go, Rust, SQL, Bash, PowerShell, YAML, JSON, Dockerfile, Kotlin, Swift, C#, C++, PHP and Ruby.
What happens without a subscription?
Markdown and code keep rendering. Mermaid diagrams then show as highlighted source, and export is off.
Not yet on the Atlassian Marketplace. This page will link to the listing when it is live.
Last updated 8 November 2026. Questions or corrections: benjamin@benjaminbritton.co.uk.