Render PDF from Markdown that is using mermaid

Thu, 12 Nov 2020 18:38:44 +0100

Mermaid and Markdown is widely supported match. With mermaid you can describe diagrams and get them rendered next to your Markdown text. It is kind of a markdown flavor, but not supported by all Markdown processors. Use this guide to get result as described in the title.

You will need:

Pandoc

brew install pandoc

pdflatex

brew cask install basictex

pandoc mermaid-filter

npm i -g mermaid-filter

After everything installed (assume that pandoc and mermaid-filter are available in your echo $PATH)

Example

This document itself is written in markdown. Access the source and save it as mermaid-pandoc-guide.md then use pandoc and the filter to create a PDF.

pandoc mermaid-pandoc-guide.md -o mermaid-pandoc-guide.pdf --toc -V papersize:a4 --highlight-style pygments -N -V geometry:"top=2cm, bottom=1.5cm, left=2cm, right=2cm" -V toc-title:"Inhaltsverzeichnis"

This mermaid graph must be rendered properly:

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

Latex on Janik von Rotz

Render PDF from Markdown that is using mermaid

Example