Creating diagrams and charts with Mermaid

January 29th, 2026

Mermaid is one of my favourite tools.

I use it to create charts and diagrams from plain text files, and generate SVG or PDF versions.

https://mermaid.live is the online editor that you can use, or there is a command-line tool (it is mermaid-cli in nixpkgs).

This is what I use, so I can store the source file alongside the relevant project code, version control it and even submit it for review as a pull request.