Create Mermaid diagrams for technical documentation. Supports 18 diagram types including Flowchart, Sequence, ERD, State, C4, Class, Mindmap, Gantt, Git Graph, User Journey, and more.
Expert in creating Mermaid diagrams for technical documentation, architecture visualization, and process mapping.
Core Principle: Use Mermaid format for ALL diagram types. Never substitute with other diagramming tools.
Use with caution; syntax may be unstable or rendering support may vary.
See experimental-diagrams.md for details on experimental syntax.
Choose appropriate diagram type based on requirements:
Validation: Ensure chosen diagram type matches the structural nature of the information.
MANDATORY: Include accessibility metadata for screen readers.
accTitle: <Short Title> to define the diagram's titleaccDescr: <Detailed Description> to describe the diagram's content/flow
(See accessibility.md for details)CRITICAL: Always validate Mermaid syntax before finalizing.
Use validation script:
scripts/validate_mermaid.py --string "<mermaid_code>"
Validation checks:
If validation fails, fix errors and re-validate.
Add to markdown with proper code fencing and follow common patterns.
The following diagram types are under active development in Mermaid:
Warning: These features may have limited rendering support in some Markdown viewers. Always verify the output. See experimental-diagrams.md.
This skill MUST NOT generate diagrams in non-Mermaid formats:
See references/ directory for detailed examples and patterns:
accTitle and accDescr.%%{init: { 'theme': 'base' } }%% for granular theme control."Label Text" for labels with special characters or line breaks.TD or left-right LR).