Mermaid 11.7.0 Release Notes

Released on June 20, 2025

Mermaid 11.7.0 introduces several enhancements, fixes, and internal improvements. Here�s a breakdown of the key changes and new features:

  1. ER Diagram Stroke Style Improvements: Stroke styles for Entity Relationship (ER) diagrams now correctly apply both path-specific and row-specific styles. This ensures that custom styling for different diagram elements is rendered as intended, improving visual consistency and clarity.
  2. FontAwesome Icons as SVGs in Flowcharts: FontAwesome icons can now be embedded as SVGs in flowcharts, provided they are registered via mermaid.registerIconPacks. This enhancement allows for richer, more customizable node visuals leveraging the extensive FontAwesome icon library.
  3. Timeline Diagram Visual Consistency: Timeline diagrams now display consistent vertical dashed line lengths with visible arrowheads. Previously, vertical lines from tasks could have inconsistent lengths depending on the number of events in each column. All vertical lines now extend to the same depth, making timelines easier to read.
  4. URL String Escaping with Absolute Arrow Markers: When arrowMarkerAbsolute: true is enabled, all unsafe characters in URLs are properly escaped. This enhances both security and compatibility by preventing incomplete string escaping during URL manipulation.
  5. Architecture Diagram Grammar Refactor: The grammar for architecture diagrams has been improved so that titles no longer break rendering, making these diagrams more robust and easier to maintain.
  6. Removal of Undefined Style Attributes: Mermaid diagrams no longer include incorrect style="undefined;" attributes in their SVG output. This improves the cleanliness of the generated SVG and prevents potential rendering issues.
  7. StateDB Conversion to TypeScript: The StateDB component has been converted to TypeScript, contributing to better code maintainability and type safety for future development.
  8. Dependency Updates: Dependencies, including @mermaid-js/parser (now at version 0.5.0), have been updated to incorporate the latest improvements and security patches.