#mdbook #mdbook-plugins #mermaid #mdbook-mermaid

bin+lib mdbook-mermaid

mdbook preprocessor to add mermaid support

34 releases

0.15.0 Mar 28, 2025
0.14.0 Sep 11, 2024
0.13.0 Dec 13, 2023
0.12.6 Dec 19, 2022
0.2.2 Jul 16, 2019

#238 in Text processing

Download history 1324/week @ 2024-12-28 2506/week @ 2025-01-04 2200/week @ 2025-01-11 1722/week @ 2025-01-18 2017/week @ 2025-01-25 1911/week @ 2025-02-01 1946/week @ 2025-02-08 1796/week @ 2025-02-15 1731/week @ 2025-02-22 1624/week @ 2025-03-01 1906/week @ 2025-03-08 2068/week @ 2025-03-15 1933/week @ 2025-03-22 2032/week @ 2025-03-29 1934/week @ 2025-04-05 1296/week @ 2025-04-12

7,488 downloads per month
Used in mdbook-dtmo

MPL-2.0 license

2.5MB
3K SLoC

JavaScript 2.5K SLoC // 0.0% comments Rust 483 SLoC

mdbook-mermaid

A preprocessor for mdbook to add mermaid.js support.

It turns this:

```mermaid
graph TD;
    A-->B;
    A-->C;
    B-->D;
    C-->D;
```

into this:

Simple Graph

in your book. (Graph provided by Mermaid Live Editor)

Installation

From source

To install it from source:

cargo install mdbook-mermaid

This will build mdbook-mermaid from source.

Using cargo-binstall

If you have cargo-binstall already:

cargo binstall mdbook-mermaid

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:

[preprocessor.mermaid]
command = "mdbook-mermaid"

[output.html]
additional-js = ["mermaid.min.js", "mermaid-init.js"]

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.

Finally, build your book:

mdbook path/to/book

Development

Update the bundled mermaid.js

Find the latest version of mermaid on https://github.com/mermaid-js/mermaid/releases. Then run:

cargo xtask <version>

This will fetch the minified mermaid.js file and commit it.

Note: mdbook-mermaid does NOT automatically update the mermaid.min.js file in your book. For that rerun

mdbook-mermaid install path/to/your/book

or manually replace the file.

License

MPL. See LICENSE.
Copyright (c) 2018-2024 Jan-Erik Rediger janerik@fnordig.de

Mermaid is MIT licensed. The bundled assets (mermaid.min.js) are MIT licensed.

Dependencies

~16–27MB
~428K SLoC