NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
PyPI · #2217 most downloaded on PyPI
Mermaid diagrams in your Sphinx-powered docs
Last release 1 months ago
01 Sep 2026
Ships unpredictably
gaps range from 1 weeks to 1.4 years
Nearly every release is documented
notes for 29 of 30 stable releases
Nothing withdrawn
no release was ever pulled
10 years old
32 releases · first in 2016
Preserve source metadata on generated Mermaid caption nodes so Sphinx extracts them into gettext catalogs and applies normal caption translations
Add mermaid_config option for passing a global Mermaid configuration
mermaid_config option for passing a global Mermaid configuration (#215)One column per quarter.
Capture mmdc error message as string for nicer error display
Add mermaid_dark_theme and mermaid_light_theme config options for configurable theme switching
mermaid_dark_theme and mermaid_light_theme config options for configurable theme switchinghtml_static_pathExport runMermaid to window for hot reloading frontend
runMermaid to window for hot reloading frontendDrop support for Python 3.8 and 3.9
Update readthedocs yaml
Update readthedocs yaml
Nothing published for this version
Fix issue with ELK charts by upgrading to ELK plugin 0.2.0
0.2.0Hotfix for CSS/JS assets included via old MANIFEST mechanism
Adjust chart size defaults to closer resember previous
Normalize javascript across various configuration options
mermaid-fullscreen-content to
mermaid-container-fullscreenAdd fullscreen graph view capabilities
Add passthrough of mermaid frontmatter
See full set of changes.
Implemented zoom on diagrams functionality. Contributed by Daniel Althviz Moré
See full set of changes.
Nothing published for this version
Default to Mermaid 9.4.0 as 10.0 introduced incompatible changes. See the discussion.
Make the class diagram reproducible
See full set of changes.
Update docs and tests for markdown support
Add compatibility with Sphinx 4.0
mermaid_init_js is now included in an standard way.Make it compatible with recent Sphinx versions
- fix regression - setup travis
Fix a problem when called mermaid-cli
Drop support for Python version older than 3.6.
Added mermaid_cmd_shell. Useful for Windows user.
Added the pdfcrop functionality
mermaid_paramspdfcrop functionalitySupport the new Mermaid CLI by Bastian Luettig
several improves and bugfixes contributed by Alberto Berti
Workaround for opacity issue with rtd's theme (thanks to Anton Koldaev)
Python 3 support fix (thanks to Shakeeb Alireza)
- Better usage instructions - Bugfix
- first public version
Your coding agent can read these notes before it upgrades. Set up the MCP server →