Mermaid & PlantUML Diagramsfor Confluence Cloud
Diagrams that live with the page.
Write Mermaid or PlantUML as text, or paste an OpenAPI description, and the diagram draws as you type. It is saved with the page, goes into PDF and Word exports, and nothing leaves Atlassian.
See it in 77 seconds.
Mermaid in the live editor, the PlantUML macro with a theme and the C4 library, the diagram drawn in the page with no server, and an export with every diagram in it.
77 seconds, with a spoken voice-over: writing Mermaid in the live editor, where the preview follows every line and a mistake is caught before saving; the new PlantUML macro with its examples, a theme and the C4 library; the diagram drawn in the page with no PlantUML server; the saved picture showing first; and a Word or PDF export with every diagram in it.
How it works
- Type /mermaid or /plantumlIn the Confluence page editor.
- Write the textStart from an example; the preview draws as you type.
- SaveChecked first, then stored with the page.
- Share and exportReaders zoom and copy it; PDF and Word carry it.
An editor that knows the syntax.
You do not need to know the syntax. Start from an example of any of 32 Mermaid or 22 PlantUML kinds, and the reference follows the diagram you are writing.
- A live preview that updates as you type, with syntax highlighting
- An example of each of 32 kinds of Mermaid diagram and 22 kinds of PlantUML, and a syntax reference that follows the one you are writing
- Saving is blocked for a diagram that will not render; revert, or go back to one of the last five saved versions
- Paste from another Mermaid app, a Markdown file or an AI chat and the wrapping comes off; a mermaid.live link becomes its diagram
- Draft with AI and Fix with AI copy a prompt for the AI chat you use; the app itself never contacts an AI
Also: find and replace with Ctrl+F (Cmd+F on a Mac), and Tab and Shift+Tab for mind maps and other nested diagrams.
Easy to read, on the page and in exports.
- Diagrams at a readable size, with zoom, Fit and full screen for large ones
- Colors that follow Confluence's light or dark mode, or a fixed scheme per diagram
- For Mermaid, a look per diagram (classic, hand-drawn or Neo) and the ELK layout for flowcharts and class, state, ER and requirement diagrams
- Pictures in PDF and Word exports; SVG or PNG downloads; the image or the source copied in one click
- Alt text, so diagrams are described to screen readers
32 kinds of Mermaid, 22 of PlantUML.
Every kind of diagram in Mermaid
12.3, the version the app includes: 32 in all, from flowcharts and
Gantt charts to mind maps. And since version 2.10.0 a second macro,
PlantUML Diagram (/plantuml), with the same
editor and viewer. PlantUML is drawn in the reader's browser,
inside the page: there is no PlantUML server, the diagram's text is
sent nowhere, and nothing is fetched from the web.
Mermaid: three of the pictures in the documentation, each drawn by the app from a few lines of text.
PlantUML: three of the pictures from Learn PlantUML, drawn the same way.
- 32 Mermaid kinds
- Flowcharts, sequence, ER, Gantt, class and state diagrams, pie charts, mind maps, user journeys, timelines, quadrant charts, git graphs and more. The reference lists them, and the recipes give a Gantt chart, a timeline and more to copy. A flowchart node can open a Confluence page or Jira issue (how).
- 22 PlantUML kinds
- Sequence, class, activity, component, state, use case, Gantt, mind map, deployment, C4, object, ER, Chen ER, timing, network, WBS, JSON, YAML, wireframe (Salt), ArchiMate, EBNF and regular expressions.
- Themes and libraries
- 43 themes, emoji and the Open Iconic icons, and the C4, ArchiMate and Kubernetes libraries.
- Not drawn
- Graphviz (
@startdot), ditaa, formulas (@startmath,@startlatex), the AWS, Azure and other icon libraries, and includes from files or web addresses. The editor says so in words. - OpenAPI
- Since 2.11.0, a third macro, OpenAPI Diagram (
/openapi): paste an OpenAPI 3.x or Swagger 2.0 description and the page shows a map of its endpoints and schemas, with the details under it. Nothing is fetched or called. See the documentation. - Learn it
- Learn PlantUML starts from nothing; the documentation covers the macro, and the reference every limit.
Compared with draw.io and Gliffy.
How the three compare, from each vendor's own public pages as read on 18 November 2026. Where theirs are stronger, the table says so.
| As of 18 November 2026 | Mermaid & PlantUML Diagrams (ours) | draw.io for Confluence | Gliffy for Confluence |
|---|---|---|---|
| How you write Mermaid | As text in the macro, with a live preview beside it. It stays text. | Pasted into a Mermaid dialog. By default it becomes draw.io shapes; the text is kept with them to edit and draw again. | Listed as a diagram type; its pages do not say how the text is edited. |
| Mermaid version | 12.3, named in our documentation | Not stated; its documentation lists the diagram types | Not stated |
| PlantUML | A second macro in the same app, drawn in the reader's browser. Graphviz, ditaa and includes are not drawn. | Yes, in the browser. Its documentation calls it a partial implementation, provided as-is. | Not mentioned on its Confluence pages |
| Data sent outside Atlassian | None, from the one app every cloud gets | None for its Forge Zero Egress app, a separate edition | None for Gliffy Zero Egress, a separate listing |
| Drawing by hand | No. The text is the diagram. | Yes: a full drawing editor with shape libraries | Yes: drag and drop, with shape libraries |
| Trust programs named | None; Runs on Atlassian | Cloud Fortified | SOC 2 Type II and ISO 42001 |
Choose draw.io or Gliffy when you want one editor for every diagram, drawn by hand, or a trust program we do not have. Choose this app when your diagrams are text you keep, review and change with the page. Sources: draw.io's Mermaid and PlantUML documentation and Atlassian page; Gliffy's Confluence and Zero Egress pages.
Every way to get Mermaid into Confluence, free ones included
Details worth knowing.
Where diagrams from older versions need one open and save, and what happens if a license lapses.
- Older diagrams and exports
- Diagrams saved before version 2.4 need one open and save to get their picture, and so do those saved before 2.6 that set their own theme or colors. Until then, Word shows their text as code, and a PDF of a page with many of them can fail.
- Very large diagrams
- A diagram too large or too tall for a picture is saved without one only when you choose, and Word then shows its text as code.
- A lapsed license
- Pages and exports keep showing each diagram as last saved. Only editing stops, and the editor says why.
- A flowchart in one long row
- Since 2.9, Mermaid 12 can draw a subgraph in the direction of the diagram around it. Why, and what to do.
Security and data.
Diagrams are drawn in your browser. For exports, page history and notification emails, Confluence hands each diagram to the app's own function on Atlassian's platform, which keeps nothing. In your browser, the editor stores only which of Dismiss, Not now or Rate it you clicked and, for Not now, how many times and when. Nothing about you or your diagrams.
This app in the trust centerSecurity review pack
Published: security policy privacy policy DPA SLA security questionnaire, answered
- Permissions
- None requestedConfirm it yourself on the install screen.
- Storage
- In the Confluence page itselfWith the picture used for exports. We hold no copy.
- Sanitization
- Always onDiagram source cannot execute scripts. Links are http and https only.
- Regulated clouds
- Listed for Isolated Cloud and Government CloudIsolated Cloud since 12 November 2026: the same app, with the same features, as in the normal cloud. Government Cloud since 20 November 2026, with all three macros (Mermaid, PlantUML and OpenAPI). Where each app is listed
- Servers and egress
- NoneRuns on Atlassian. Draft with AI and Fix with AI only copy a prompt to your clipboard.
Pricing.
Free for up to ten users. Above that, one price a year for the whole site, set by its user tier. List prices on the Atlassian Marketplace, in US dollars, as read on 18 November 2026.
- Up to 10 usersFreeno time limit
- 25 users$87.50a year
- 50 users$175a year
- 100 users$350a year
- 200 users$620a year
- 500 users$1,255a year
- 1,000 users$2,255a year
- 2,000 users$4,055a year
- Every tier
- From 15 up to 250,000 users, and monthly billing per user, on the Marketplace listing and its price calculator.
- Billed by Atlassian
- You buy, renew or cancel the app through your Atlassian site's billing, with your other subscriptions.
- Isolated Cloud and Government Cloud
- Each has its own price list, shown on the app's listing for that cloud.
- One license
- Covers all three macros, Mermaid, PlantUML and OpenAPI, on the whole site.
Try it on your own Confluence site.
Mermaid & PlantUML Diagrams is on the Atlassian Marketplace for Confluence Cloud, with a free trial. One app and one license for all three macros, and a site with up to ten users pays nothing for it. Prices are above and on the listing.
- Moving from another Mermaid app?
- Moving a diagram over takes a paste: the wrapping comes off, and the options compared says how the apps differ.
- Like the app?
- Rate it on the Marketplace. A rating, good or bad, helps other Confluence teams decide.
- Support
- Read the documentation or the common questions, then email [email protected] or use the support portal. First reply in one to three business days, depending on severity (see the SLA).
Questions people ask.
How do I add a Mermaid diagram to a Confluence Cloud page?
Install the app, edit the page, type /mermaid on an empty line and select Mermaid Diagram. Write the diagram as text and the preview draws it as you type. The guide How to add Mermaid diagrams to a Confluence Cloud page walks through it.
Does it support PlantUML?
Yes. Since version 2.10.0 the app has a second macro, PlantUML Diagram: type /plantuml in the page editor. It is the same app, with the same license, and PlantUML is drawn in the reader's browser with no PlantUML server. Start with Learn PlantUML.
Can it show an OpenAPI or Swagger description?
Yes. Since version 2.11.0 the app has a third macro, OpenAPI Diagram: type /openapi and paste an OpenAPI 3.x or Swagger 2.0 description, YAML or JSON. The page shows a map of its endpoints and schemas, with parameters, responses and examples under it. Nothing is fetched or called, and there is no Try it out. See OpenAPI in Confluence.
draw.io and Gliffy draw Mermaid too. Why a separate app?
It depends on how you work. In draw.io, Mermaid text becomes draw.io shapes by default, and Gliffy lists Mermaid as one diagram type in its drag-and-drop editor. Here the text is the diagram: you write it beside a live preview, and it stays text you can change later. If you want one editor for every diagram, drawn by hand, theirs are stronger. The comparison above has the details.
Do diagrams appear in PDF and Word exports?
Yes. Diagrams go into PDF and Word exports as pictures. Diagrams saved before version 2.4 need one open and save to get their picture. The documentation explains exports.
Is the diagram text sent anywhere?
No. The app requests no scopes and sends nothing outside Atlassian. Diagrams are drawn in your browser and stored in the Confluence page itself, and we hold no copy. The trust center has the details.
How much does it cost?
A site with up to ten users pays nothing for it, and one license covers all three macros: Mermaid, PlantUML and OpenAPI. Prices for larger sites, and a free trial, are on its Marketplace listing.
What happens if our license lapses, or we uninstall?
If the license lapses, pages and exports keep showing each diagram as it was last saved; only editing stops, and the editor says why. If you uninstall, the diagrams' text stays in your pages as page content.
Can I move diagrams from another Mermaid app?
Yes. Paste the diagram's text into the editor: the wrapping from another Mermaid app, a Markdown file or an AI chat comes off, and a pasted mermaid.live link becomes its diagram. See Moving a diagram from another Mermaid app.
Can I make Gantt charts in Confluence?
Yes. Gantt charts are one of the 32 kinds of Mermaid diagram the app draws, written as text. The guide Gantt charts in Confluence Cloud, with Mermaid shows how.
Does it work on Confluence Data Center?
No. It is built on Atlassian Forge for Confluence Cloud, not Data Center or Server. Moving from Data Center says how your Mermaid and PlantUML diagrams come across to Cloud.
Is it available in Atlassian Isolated Cloud or Government Cloud?
Yes. It has been listed in Isolated Cloud since 12 November 2026, with the same features as in the normal cloud, all three macros included. It is also listed in Atlassian Government Cloud since 20 November 2026, with all three macros (Mermaid, PlantUML and OpenAPI). Regulated clouds says where each app is listed.
Is this the app that was called Mermaid Diagrams & Gantt?
Yes. It is the same app, on the same Marketplace listing; the name changed when PlantUML joined it. Before that it was called Mermaid Studio. Diagrams already on your pages keep working.
Who is behind this app?
Eriksen Labs, an independent software company in Norway (Eriksen ENK, org. no. 937 027 834). We build Mermaid & PlantUML Diagrams and support it ourselves, with a first reply in one to three business days (see the SLA). It runs on Atlassian's platform; we operate no servers.
Guides
All guides- How to add Mermaid diagrams to a Confluence Cloud pageThree ways, step by step, and the problems people hit the first time.
- Mermaid diagrams in Confluence Cloud: how the options compareA picture, the free viewer, draw.io and the macro apps, ours included.
- Gantt charts in Confluence Cloud, with MermaidDependencies, milestones, skipped weekends, and what exports show.
- Learn PlantUML: a beginner's guide to diagrams as textFrom a first diagram to one kind at a time, with the usual mistakes.