pretty-mermaid

Render Mermaid diagrams from code or files to SVG or ASCII with themes.

278|26|Updated Jan 14, 2026
One-click install
npx skills add https://github.com/ninehills/skills --skill pretty-mermaid
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: pretty-mermaid
Source: https://github.com/ninehills/skills/tree/main/skills/pretty-mermaid
Command: npx skills add https://github.com/ninehills/skills --skill pretty-mermaid

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires beautiful-mermaid, and includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

Render complex Mermaid diagrams quickly and consistently without manual styling, producing visuals that fit documentation, presentations, and terminal previews.

Core Features & Use Cases

  • Multi-format rendering: SVG for web/docs and ASCII for terminal previews.
  • Themed diagrams: 15+ built-in themes to match dark/light environments.
  • Diagrams supported: Flowchart, Sequence, State, Class, ER diagrams, with batch processing.
  • Use Case: Produce ready-to-embed diagrams from user-provided Mermaid code or .mmd files for docs, dashboards, and specs.

Quick Start

Render a diagram by running the render.mjs script with your Mermaid file and a theme.

Frequently Asked Questions about pretty-mermaid

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

FAQPage Schema
How do I render Mermaid diagrams into SVG files for documentation?

To render Mermaid diagrams into SVG files, run the render.mjs script with your .mmd file and a chosen theme, generating ready-to-embed SVG visuals suitable for web pages and technical docs.

Can I preview Mermaid flowcharts directly in the terminal?

Yes, you can preview Mermaid flowcharts in the terminal by rendering them as ASCII output, supporting terminal previews without needing a graphical interface or web browser.

Do I need Node.js to batch render multiple Mermaid diagrams?

Yes, Node.js is required to batch render multiple Mermaid diagrams. The Skill relies on the Node.js environment and the beautiful-mermaid library to execute its CLI rendering scripts.

What diagram types are supported when rendering Mermaid code?

Rendering Mermaid code supports flowchart, sequence, state, class, and ER diagram types, processed individually or through batch rendering with consistent visual themes.

Are there built-in themes for Mermaid diagrams to match dark mode?

Yes, there are 15+ built-in themes for Mermaid diagrams to match dark or light environments, applied during rendering to ensure your visuals fit your presentation context.