Create and maintain diagrams directly in Confluence

Write Mermaid, check a clear side-by-side preview as you type, and save. Each save is kept as a revision, so readers see the diagram you saved and you can reopen, edit, or restore it later.

Start a free 30-day trial on Atlassian Marketplace

A Confluence Cloud site admin installs it from Marketplace. After the trial: USD 3.35 per user per month at Marketplace list price.

The user problem

Why this exists

Diagrams in technical docs need upkeep. The work gets harder when the diagram lives somewhere else, when you can't see what will render before saving, or when an edit could silently replace the last good version.

Keeping an architecture or sequence diagram current as the system changes
Not knowing what a Mermaid edit will look like until after it is saved
Losing the last good version of a diagram after a bad edit
Recovering the Mermaid source behind a diagram on a page

What it does

Focused capabilities

✓Mermaid editor inside the Confluence macro, with Code, Preview, and Split modes
✓Live draft preview, with syntax errors shown before you save
✓Every save stored as a separate revision; earlier revisions can be restored
✓Readers see the saved diagram on the page
✓Copy or download the Mermaid source (.mmd) or the diagram (.svg) from any revision
✓Runs on Atlassian Forge with no external rendering service

How it works

Insert

Add the Better Diagrams macro to a Confluence page. The editor opens automatically.

Preview

Type or paste Mermaid. The preview updates as you type and shows syntax errors before you save.

Save and maintain

Save a revision. The page shows it. Reopen the macro any time to edit, or restore an earlier revision.

View a short product walkthrough

Better Diagrams editor in Confluence: Mermaid source on the left, draft preview on the right, Save Revision button at the top — The editor in Split mode on a Confluence Cloud test site: Mermaid source on the left, draft preview on the right.

Evidence and testing

Better Diagrams is a new app. It has no Marketplace reviews yet, and we are not claiming customer adoption.

Privacy and security

Diagrams are rendered in your browser. Mermaid source is never sent to an external rendering service.

Diagram source and saved revisions are stored in Atlassian-hosted Forge storage. The app collects content-free usage counts (for example, “a first diagram was saved”) under a pseudonymous site identifier. It never collects diagram content, page titles, names, or email addresses. See the privacy policy.