Pretty-mermaid-skills: To provide AI with Mermaid chart rendering capability, supporting both SVG and ASCII output formats

Pretty-mermaid-skills: To provide AI with Mermaid chart rendering capability, supporting both SVG and ASCII output formats
Hero image

🔗 View on GitHub: imxv/Pretty-mermaid-skills

🚀 Quick Installation

Render Mermaid diagrams as beautiful SVGs or ASCII art.

npx

npx skills add https://github.com/imxv/pretty-mermaid-skills --skill pretty-mermaid

What It Does

A Mermaid diagram rendering skill for AI, supporting both SVG and ASCII output formats to make your documentation more vivid.

  • 📊 Multi-format Support — SVG and ASCII rendering export
  • 🎨 Rich Themes — 15 built-in themes for different scenarios
  • 📈 Full Diagram Support — Flowchart, Sequence, State, Class, ER and more
  • High Performance — Batch parallel rendering
  • 📚 Ready to Use — Complete templates and detailed documentation

Available Themes

Light Themes

  • zinc-light, tokyo-night-light, cappuccin-latte, github-light, solarized-light

Dark Themes

  • zinc-dark, tokyo-night, tokyo-night-storm, cappuccin-mocha, github-dark, solarized-dark

Other

  • nord, nord-light, dracula, one-dark

Supported AI Environments

  • Claude Code
  • Cursor
  • Gemini CLI
  • Antigravity
  • OpenCode
  • Codex
  • qoder

Example Usage

# Render single diagram
node scripts/render.mjs \
  --input diagram.mmd \
  --output output.svg \
  --theme tokyo-night

# Batch render
node scripts/batch.mjs \
  --input-dir ./diagrams \
  --output-dir ./output \
  --theme dracula

# Preview themes
node scripts/themes.mjs

Example Diagrams

Check the 5 template files in assets/example_diagrams/:

  • flowchart.mmd — Flowchart
  • sequence.mmd — Sequence Diagram
  • state.mmd — State Diagram
  • class.mmd — Class Diagram
  • er.mmd — ER Diagram

📚 Detailed Usage Guide | 📜 MIT License

About the author
Subin Park

Subin Park

Principal Designer | Ai-Driven UX Strategy Helping product teams deliver real impact through evidence-led design, design systems, and scalable AI workflows.

Ai for Pro

Curated AI workflows, prompts, and playbooks—for product designers who build smarter, faster, and with impact.

Ai for Pro - Curated AI workflows and Product Design guides—built for Product Designers, PMs, and design leaders.

Great! You’ve successfully signed up.

Welcome back! You've successfully signed in.

You've successfully subscribed to Ai for Pro - Curated AI workflows and Product Design guides—built for Product Designers, PMs, and design leaders..

Success! Check your email for magic link to sign-in.

Success! Your billing info has been updated.

Your billing was not updated.