mermaid-diagrams

Create and render Mermaid diagrams from text for architecture, flows, and data models.

Updated Mar 30, 2026
One-click install
npx skills add https://github.com/erlebach/gordon --skill mermaid-diagrams-erlebach
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: mermaid-diagrams
Source: https://github.com/erlebach/gordon/tree/main/skills/illustration_skills/mermaid-diagrams
Command: npx skills add https://github.com/erlebach/gordon --skill mermaid-diagrams-erlebach

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Mermaid-based diagrams transform plain text into visual system architectures, data flows, and models, enabling version-controlled diagrams that stay in sync with codebases.

Core Features & Use Cases

  • Diagram Type Selection: class, sequence, flowchart, ERD, C4, state, and more for versatile documentation.
  • Frontmatter-driven Configuration: theme, layout, and look settings to tailor rendering.
  • Export & Embed: render to PNG/SVG, export-ready Markdown, and live previews in IDEs.

Quick Start

Create a simple Mermaid diagram by starting with a diagram type and a few elements, then render to verify.

Frequently Asked Questions about mermaid-diagrams

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate Mermaid diagrams from text for system architecture documentation?

You can generate Mermaid diagrams from text by defining a diagram type and its elements, which renders plain text into visual architectures and flows. This keeps version-controlled diagrams synchronized directly with your codebase and docs.

What types of diagrams can I create using Mermaid for software design reviews?

Mermaid supports class, sequence, flowchart, ERD, C4, and state diagrams for software design reviews. These diagram types visualize API workflows, data models, and system architectures across codebases and documentation.

Can I configure Mermaid diagram themes and layouts using frontmatter?

Yes, you can configure Mermaid diagram themes, layouts, and look settings using frontmatter. This frontmatter-driven configuration tailors rendering output to match your specific documentation style and visual requirements.

How do I export Mermaid diagrams to PNG or SVG for pipeline integration?

You can export Mermaid diagrams to PNG or SVG using the Mermaid CLI for pipeline integration. This export capability produces export-ready Markdown and image files suitable for integration into automated documentation workflows.

Are Mermaid text diagrams suitable for visualizing API workflows and data models?

Mermaid text diagrams are specifically applicable to visualizing API workflows and data models. They transform plain text into visual representations like ERDs and sequence diagrams, enabling clear system documentation for codebases.

What is the best way to keep version-controlled diagrams in sync with my codebase?

The best way to keep version-controlled diagrams in sync with your codebase is using Mermaid text diagrams. Because they are plain text, the diagrams stay natively synchronized with code changes and ready-made examples during reviews.