Mermaid
An open JavaScript diagramming tool whose concise syntax generates flowcharts, sequences, state diagrams, journeys, Git graphs, and timelines.
Why use it
Embedding diagrams in repository docs gives design reviews, diffs, and site publishing the same workflow as code, ideal for living system explanations.
Where it fits
Use prototypes and playtests to find core experience problems while they are still cheap to fix.
What to check
Complex layout and pixel-level styling are limited, and renderer versions can change output; do not send secret diagrams to an uncontrolled online editor.