What's new in Mermaid Studio 2026.1.7?

2026.1.7 Release Notes

This release delivers meaningful performance and memory improvements for diagram rendering, especially in Markdown files with many diagrams. It also brings deep GitGraph support with structure view, navigation, and refactoring, new State Diagram completions and inspections, and resilience improvements across multiple diagram parsers.

Highlights

• Faster Markdown Rendering — Diagram rendering in Markdown files is significantly faster, with noticeably lower latency when working with files that contain many Mermaid code fences
• Lower Memory Usage — Memory management for diagram preview and export has been reworked to reduce allocation overhead, keeping the IDE responsive during extended editing sessions
• GitGraph Support — Structure view, code folding, completions, refactoring, and inspections bring GitGraph diagrams up to the same level of IDE support as other diagram types
• State Diagram Support — New completions and inspections catch common mistakes and make State Diagrams easier to write
• Parser Resilience — Improved error recovery across multiple diagrams so a single unexpected character no longer causes subsequent valid statements to be unparsed

---

Added

• Added structure view for GitGraph diagrams with branch segment grouping, commit/merge/cherry-pick tree, and metadata entries
• Added code folding for GitGraph branch/checkout segments and multi-line accDescr blocks
• Added navigation bar support for GitGraph diagrams with context-aware icons and text
• Added cherry-pick validation inspection for GitGraph diagrams: detects invalid parent references, merge commits without a parent attribute, cherry-picking from the current branch, and cherry-picking onto an empty branch, with quick fixes to add or remove the parent attribute
• Added GitGraph code completions: statement keywords, direction values, context-aware attribute keys, commit types, branch references, and commit ID references
• Added GitGraph auto-quoting typed handler for attribute values and balanced-quote backspace handling
• Added Find Usages support and inline rename refactoring support for GitGraph branches and commits
• Added “Declare branch” quick fix for unresolved GitGraph branch references, inserting branch <name> on the previous line
• Added duplicate tag detection for GitGraph diagrams
• Added pie chart duplicate slice label inspection
• Added Timeline annotator that flags missing whitespace after colons, with a quick fix to insert a space
• Added State Diagram completions: context-specific operators, keywords, direction values, stereotypes, note positions, and state references
• Added State Diagram completion icons
• Added State Diagram annotators for invalid direction values, transition chains, concurrent separator validation, and composite state cycle detection (direct, indirect, and via transition/inline references)

Changed

• Improved memory management for diagram preview and export
• Improved Mermaid diagram rendering performance in Markdown files with a large number of diagrams
• Enhanced semantic highlighting for Mermaid code fences in Markdown preview
• Changed Kanban column identifier highlighting from keyword to class declaration style
• Added multiline string continuation line alignment to the flowchart formatter
• Improved GitGraph completion support and error resilience

Fixed

• Fixed Mindmap multiple-roots error not clearing when adjusting indentation with spaces
• Fixed false positive whitespace error on trailing whitespace after quoted labels in flowchart node shapes (e.g., A["text" ] is valid)
• Fixed missing whitespace validation for flowchart subgraph titles with quoted labels
• Fixed instances where declarations are incorrectly included in reference count, impacting Find Usages and code vision inlays
• Fixed mismatched background colors between code fence container and syntax-highlighted source view in Markdown preview
• Fixed GitGraph not highlighting correctly when typing
• Fixed Requirement not detecting certain improper unquoted property values that would cause rendering issues
• Fixed ER Diagram not renaming all references to an entity when renaming from a reference site
• Fixed parser error recovery for a number of diagrams where a single unexpected character at statement start no longer causes all subsequent valid statements to be unparsed
• Fixed flowchart parser allowing multiple nodes without separators on the same line inside subgraphs
• Fixed XY Chart parser not recovering inside bar/line data arrays when encountering an invalid value
• Fixed State Diagram hide empty description being flagged as a parse error