pandoc-mermaid-filter

Pandoc filter for mermaid code blocks


License
MIT
Install
pip install pandoc-mermaid-filter==0.1.0

Documentation

pandoc-mermaid-filter

Pandoc filter which converts mermaid code blocks to mermaid images.

```mermaid
gantt
        dateFormat  YYYY-MM-DD
        title Adding GANTT diagram functionality to mermaid
        section A section
        Completed task            :done,    des1, 2014-01-06,2014-01-08
        Active task               :active,  des2, 2014-01-09, 3d
        Future task               :         des3, after des2, 5d
        Future task2               :         des4, after des3, 5d
        section Critical tasks
        Completed task in the critical line :crit, done, 2014-01-06,24h
        Implement parser and jison          :crit, done, after des1, 2d
        Create tests for parser             :crit, active, 3d
        Future task in critical line        :crit, 5d
        Create tests for renderer           :2d
        Add to mermaid                      :1d
```

Usage

Install it with pip:

pip install pandoc-mermaid-filter

And use it like any other pandoc filter:

pandoc tests/sample.md -o sample.pdf --filter pandoc-mermaid

The mermaid binary must be in your $PATH or can be set with the MERMAID_BIN environment variable.

But there is ...

There are a few other filters trying to convert mermaid code blocks however they all failed for me.

Troubleshoot

I've had to install the mermaid CLI locally instead of globally. See https://github.com/mermaidjs/mermaid.cli/issues/16