Mermaid can be plugged into Pandoc, so you can create decent PDF docs in Markdown that include diagrams. We store the Markdown files in git and have a Makefile

Mermaid can be plugged into Pandoc, so you can create decent PDF docs in Markdown that include diagrams. We store the Markdown files in git and have a Makefile that converts to PDF.