Alternative to Mermaid diagrams viewer (Atlassian Labs)
Dated facts about Vellnar Diagrams and Mermaid diagrams viewer by Atlassian Labs, when the other app is the better choice, and how to move a diagram.
Last updated
The short answer
Mermaid diagrams viewer by Atlassian Labs is free and open source. It draws the Mermaid code that you write in a normal Confluence code block on the same page. It is a viewer; Vellnar Diagrams adds an editor with a live preview, templates, exports and a documented PDF result, and it is a paid app.
Facts side by side
We read these facts on 19 November 2026 in the public Marketplace listing and in the vendor’s own documentation, for version 2.82.0 of 4 November 2026. “Not documented” means that the pages we read do not say; it does not mean no. Prices are the Marketplace prices in US dollars on that day.
The app’s source code is public. The facts below come from its README and from the code of the main branch, read on 19 November 2026; the published version may differ slightly.
| Fact | Vellnar Diagrams | Mermaid diagrams viewer |
|---|---|---|
| Live preview while you type | Yes, at every keystroke | No editor. You type the code in a Confluence code block and the macro draws it on the page |
| Zoom and pan | Yes, in full screen and in the editor | Yes, in the dialog that a click on the diagram opens |
| Full screen for readers | Yes, from a button on the diagram | Yes, a click opens the diagram in a large dialog |
| Diagram in the Confluence PDF export | Yes, as a vector picture. A Word export shows the code | Not documented. An open issue reports that the Word export fails |
| Download of one diagram | SVG and PNG; copy as image, SVG code or Mermaid code | No |
| Where the code is stored | In the macro, inside the page | In a code block of the page |
| Permissions asked at install | None | 1: view pages |
| Runs on Atlassian badge | Yes | Yes |
| Data outside Atlassian | None. The app makes no outside connection | None. The listing states that the app does not store or send out any data |
| Mermaid version | 12.3 | 11, ^11.16.1 in the source |
| Price for 100 users | USD 30 per month or USD 300 per year, the planned price at launch. 30-day free trial | Free |
When Mermaid diagrams viewer is the better choice
- You need diagrams drawn from code and nothing more. It is free for any number of users.
- You want the code as ordinary page text. A code block stays readable and editable if the app is removed, and every Confluence tool can read it.
- You want to read the source code of what you install, or change it: the app is open source under the Apache 2.0 license.
- You have a few diagrams that rarely change, so an editor with a preview would not pay for itself.
When Vellnar Diagrams fits better
- People write diagrams often and need to see the result while they type, with the error marked on its line.
- The page should show the diagram only, not the diagram and its code block.
- You need newer diagram types: Vellnar Diagrams draws with Mermaid 12.3, the viewer with Mermaid 11.
- Pages go to PDF and the diagram must be in it, sized as you chose.
Move a diagram from Mermaid diagrams viewer
Vellnar Diagrams has no import tool yet, so a diagram moves by copy and paste. The code is the diagram, so nothing is lost.
- Take the Mermaid code out of the Atlassian Labs viewer. Use the way that matches your diagram:
- Edit the page and find the code block that the macro draws. By default it is the nearest Mermaid code block; the macro settings say which one if the author chose it.
- Select the text of the code block and copy it.
- On the same page, type
/mermaidand select Mermaid diagram. - Choose Start blank, paste the code and check the preview. If a line has an error, the editor marks it.
- Choose Save, compare the new diagram with the old one, then delete the old macro and publish the page.
After the new diagram is saved, remove the old macro and its code block, or keep the code block if you want the code visible on the page. The viewer supports Font Awesome icons and custom styles; check the diagrams that use them.
Move a few diagrams during the 30-day free trial before you decide. Both apps can stay installed while you compare.
Sources
Apps change. If a fact on this page is out of date, write to the address on this page and we correct it. Product names belong to their owners; Vellnar is not affiliated with Atlassian Labs.
See also Mermaid in Confluence and the documentation of Vellnar Diagrams.