mermaid-diagram

Generating a Mermaid flowchart from text involves mapping your natural language diagram requirements into appropriate Mermaid syntax and saving the source as a .mmd file. The Skill interprets your description, selects the correct diagram type, and writes the raw code automatically.

You can verify Mermaid syntax by rendering a PNG through the Mermaid CLI (mmdc or npx fallback) after generating the code. The Skill executes this rendering step to check for syntax errors and iterates up to three times to fix any issues found.

Creating Mermaid diagrams from textual specs supports multiple types including flowcharts, sequence diagrams, class diagrams, ER diagrams, and Gantt charts. The Skill interprets your specific requirements and maps them to the appropriate Mermaid diagram format.

Rendering Mermaid diagrams requires the Mermaid CLI, which depends on npx or the mmdc command to execute syntax verification. The Skill uses these dependencies to render a PNG preview and validate the generated diagram code.

Mermaid diagram generation may fail to produce a preview if the mmdc or npx CLI encounters syntax errors it cannot resolve within three iterations. The Skill attempts to fix errors up to three times during the rendering verification process before giving up.

Documenting system architecture using Mermaid is best achieved by generating verified source files and Markdown wrappers in a figures directory. The Skill creates both .mmd and .md files, ensuring your architecture documentation is ready for preview and integration.