[hm-nah]

You can use Mermaid in your markdown files.

[rossmohax]

I second this. Gitlab supports Mermaid out of the box, which helps