It is. We write all our technical documentation (as well as specs, etc. even meeting minutes) using markdown with embedded mermaid diagrams, and during CI have

It is. We write all our technical documentation (as well as specs, etc. even meeting minutes) using markdown with embedded mermaid diagrams, and during CI have it transformed (via pandoc and ad-hoc scripting) into PDF with corporate company headers. Looks gorgeous and has all the benefits of version controlled textual doc.