All Projects → timofurrer → pandoc-mermaid-filter

timofurrer / pandoc-mermaid-filter

Licence: MIT license
Pandoc filter for mermaid code blocks

Programming Languages

python
139335 projects - #7 most used programming language

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.

By setting the environment variable PUPPETEER_CFG, you can pass a custom configuration file to mermaid (-p option).

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 mermaidjs/mermaid.cli#16

Note that the project description data, including the texts, logos, images, and/or trademarks, for each open source project belongs to its rightful owner. If you wish to add or remove any projects, please contact us at [email protected].