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.

  1. 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.
  2. On the same page, type /mermaid and select Mermaid diagram.
  3. Choose Start blank, paste the code and check the preview. If a line has an error, the editor marks it.
  4. 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.