Skip to content

What's new in Mermaid Studio 2026.4.8?

Released:

Mermaid Studio 2026.4.8 bundles Mermaid.js 12.3.0 and supports its new flowchart step animation, which plays a diagram’s edges in the order you number them.

This release also refreshes the toolbar on Mermaid diagrams in the Markdown preview, adds support for read-only diagram files, and catches more lifecycle mistakes in sequence diagrams.

Mermaid.js 12.3 can play a flowchart as a sequence of steps. Give an edge an ID and a step number, and a dot travels the edges in that order, so a reader can follow a request through the diagram one hop at a time. Edges that share a number play together.

flowchart LR
Order e1@--> Payment
Payment e2@--> Shipping
e1@{ step: 1 }
e2@{ step: 2 }

Completion offers step on a named edge, along with the two frontmatter settings that go with it: stepNumbers draws each edge’s number in a badge, and stepDuration sets how long a step takes. In the clip below, six numbered edges read as one request’s round trip, from the client to the database and back. Turning on Edit Mode then stops the animation, so the moving dot doesn’t get in the way of selecting elements:

Exported PNG images leave out the moving dot, so a still shows the whole flow and not one step of it. To try it, insert the new Step-by-step flow sample from the sample picker.

Mermaid.js 12.3.0 is now the default runtime. The 11.16.1 bundle is removed; if your version setting named it, it switches to 11.17.2 and a notification tells you so. See the bundled versions for the full list.

Mermaid.js 12.3 also accepts more forms of flowchart edge ID, and the editor matches it. IDs with characters such as - and : no longer show syntax errors, and a form that only 12.3 reads is flagged with a quick fix when you select an older runtime.

The controls that appear when you hover a Mermaid diagram in the Markdown preview are now one toolbar in the diagram’s top-right corner. The zoom buttons, Open in new window, and Show source are grouped there, in the IDE’s own toolbar style. Actual size is new, and it replaces the zoom percentage field. In the clip below, the refreshed toolbar makes an architecture diagram that is too small to read at document width legible in place, without leaving the page:

Actual size shows a diagram at its natural width and holds it there while you resize the preview. See Markdown integration for the rest.

Zoom buttons across Mermaid Studio now put zoom in before zoom out, the same order as the IDE’s image editor.

JetBrains Air renders Mermaid diagrams inline in a chat and can open one in an editor as a read-only file. Mermaid Studio now supports read-only diagram files: the live preview works as usual, while Edit Mode and the other actions that change the source, such as the Appearance and Layout menus and the Element Style pane, are disabled. This applies to any read-only diagram file, not only one opened from Air.

The sequence lifecycle inspection now separates what Mermaid.js refuses to render from what it renders differently than you wrote it, as errors and warnings. New warnings cover a create or destroy separated from its message, a participant used after it is destroyed, and an activation that is never closed. A stray end or else is reported on its own line, and the rest of the diagram keeps its highlighting, completion, and inspections.

In swimlane diagrams, a new inspection reports a node listed in more than one lane, which Mermaid.js draws only in the first.

  • Mermaid.js 12.3.0 bundled as the default runtime version
  • Flowchart, swimlane: the step edge property from Mermaid.js 12.3.0 gets completion, a warning for a value that is not a positive integer, and a warning on older runtime versions
  • Frontmatter: completion offers flowchart stepDuration and stepNumbers on Mermaid.js 12.3 and later, in flowchart and swimlane diagrams
  • Preview: flowchart step animation stops in edit mode, which keeps the step number badges
  • Export: PNG images of a step-animated flowchart from export, copy, print, and Diagram Sync leave out the moving dot and highlight
  • Sample picker: a Step-by-step flow sample shows flowchart step animation, offered on Mermaid.js 12.3 and later
  • Flowchart: an edge ID placed directly after a node shape, or after @{…} and a space, is an error on Mermaid.js versions before 12.3, with a quick fix for each
  • Flowchart: an unquoted @ in a node shape, subgraph title, or edge label is an error on Mermaid.js versions before 12.3, with a quick fix
  • Flowchart: renaming an edge rejects names Mermaid.js cannot read back, such as names containing @
  • Flowchart, swimlane: the nine bpmn-* node shapes from Mermaid.js 12.3.0 are accepted in shape:, with an error on older runtime versions
  • Swimlane: an inspection reports a node listed in more than one lane, which Mermaid.js draws only in the first
  • Preview: read-only diagram files are supported, with edit mode and the appearance, layout, and Element Style actions disabled
  • Sequence: the lifecycle inspection reports create of a participant that already exists
  • Sequence: the lifecycle inspection warns when a create or destroy is separated from its message, a participant is used after it is destroyed, or an activation is never closed or still open at destruction
  • Preview, export, and theme editor: zoom in comes before zoom out, as in the IDE’s own image editor
  • Markdown: the hover controls on Mermaid fences are one restyled toolbar of zoom buttons, Open in new window, and Show source; Actual size replaces the zoom percentage field
  • Preview: the zoom percentage shows past the end of the zoom controls, out of the way of toolbar tooltips
  • Style pane: a flowchart node with an undocumented shape such as composite or choice shows the shape’s name without an empty icon slot
  • Diagram Sync: changing sync rules while a diagram’s sync status is being checked no longer fails the check
  • Remote development on a host older than 2026.2.2: Option+Left and Option+Right move by word again in a sequence diagram’s inline editor on macOS
  • Flowchart: edge IDs containing -, :, and the other characters Mermaid.js accepts no longer show syntax errors
  • Flowchart: an edge ID on the line after its source node, or starting with a keyword such as end-1, is now reported as a syntax error
  • Flowchart: a link on the line after its edge ID no longer shows a syntax error
  • Flowchart: adding an animation to an edge after @{…} no longer writes an edge ID that Mermaid.js versions before 12.3 cannot parse
  • Sequence: a stray end, else, and, or option is reported on its own line, and the rest of the diagram keeps its highlighting, completion, and inspections
  • Sequence: a destroying message without a cross arrow, or sent by the destroyed participant, is no longer reported as an error
  • Sequence: the lifecycle and box inspections keep reporting in a diagram with syntax errors, leaving out only problems an unreadable line could resolve
  • Sequence: create participant inside a block is no longer flagged for moving to diagram level
  • Bundled Mermaid.js 11.16.1; a version setting that names it switches to 11.17.2 and says so in a notification