unstale

pypi / sphinxcontrib-mermaid

sphinxcontrib-mermaid

What changed in sphinxcontrib-mermaid 2, from its official release notes, upgrade guides and advisories. Sources checked 2026-10-19.

1 new APIs and options1 performance10 fixes and other

See which of these apply to your code, ranked, in your agent:

npx @unstale/cli init

@unstale/cli on npm

sphinxcontrib-mermaid 212 changes

New APIs and options 1

  • Adds an option for passing a global Mermaid configuration.

    2.1.0release notes

Performance 1

  • Loads the ZenUML plugin only on pages that contain a ZenUML diagram.

    2.1.0release notes

Fixes and other changes 10

  • Generated Mermaid caption nodes preserve source metadata so Sphinx can extract them into gettext catalogs and apply normal caption translations.

    2.1.1release notes

  • The HTML visitor passes the existing Mermaid image class through, making PNG output consistently targetable with CSS.

    2.1.1release notes

  • Fixes d3 zoom on nested SVGs.

    2.1.0release notes

  • Fixes fullscreen button positioning inconsistency.

    2.1.0release notes

  • Fixes interactions between the fullscreen, zoom, and lazy-render features.

    2.1.0release notes

  • Skips injecting Mermaid JavaScript when the output format does not support it.

    2.1.0release notes

  • Confines the injected ZenUML stylesheet to the diagram subtree so it no longer restyles the host theme.

    2.1.0release notes

  • Root-level pages now use a valid relative ES module specifier for local JS module imports.

    2.0.3release notes

  • Diagrams hidden by a parent are rendered when they become visible, fixing broken SVGs.

    2.0.3release notes

  • mmdc error messages are captured as strings for nicer error display.

    2.0.3release notes