mdbook-mermaid is a preprocessor designed to integrate Mermaid.js diagrams into mdBook projects. It enables users to include charts, flowcharts, Gantt diagrams, class diagrams, and more directly within their documentation.
Key Features:
Supports a wide range of Mermaid diagram types including flowcharts, Gantt charts, class diagrams, and ERD.
Automatically generates HTML output with integrated Mermaid.js rendering when building your mdBook project.
Compatible with winget for easy installation.
Audience & Benefit: Ideal for developers, technical writers, and anyone using mdBook to create comprehensive documentation. By adding visual elements like diagrams and charts, users can enhance the clarity and engagement of their content without leaving their existing workflow.
This will download and install the pre-built binary for your system.
Manually
Binary releases are available on the Releases page.
Download the relevant package for your system, unpack it, and move the mdbook-mermaid executable into $HOME/.cargo/bin:
Configure your mdBook to use mdbook-mermaid
When adding mdbook-mermaid for the first time, let it add the required files and configuration:
mdbook-mermaid install path/to/your/book
This will add the following configuration to your book.toml:
It will skip any unnecessary changes and detect if mdbook-mermaid was already configured.
Additionally it copies the files mermaid.min.js and mermaid-init.js into your book's directory.
You find these files in the src/bin/assets directory.
You can modify mermaid-init.js to configure Mermaid, see the Mermaid documentation for all options.
