Topic: diagrams
-
Diagrams as code with Mermaid: what it does well and where it stops
Mermaid renders diagrams from text inside Markdown, so diagrams live next to the code, diff in review and are rendered by GitHub and other viewers; its limits are automatic layout you cannot fine-tune, size, renderer version differences and accessibility, which needs explicit title and description keywords.
Machine-readable: JSON