pretty-mermaid

Render Mermaid diagrams as SVG or ASCII art with configurable themes in Node.js.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

Mermaid diagrams often require an rendering step to become viewable visuals; this Skill automates rendering to SVG or ASCII, enabling quick sharing in docs, design reviews, and presentations.

Core Features & Use Cases

  • Single-diagram rendering: Renders any Mermaid diagram to SVG or ASCII with a chosen theme.
  • Batch rendering: Processes multiple diagrams in parallel for faster pipelines.
  • Theming & formatting: Applies themes, background/foreground colors, and ASCII output options for terminal workflows.

Quick Start

Render a Mermaid diagram by saving your code to diagram.mmd and running the render.mjs script with a chosen 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 to SVG for documentation?

You can render Mermaid diagrams to SVG by saving your code to a .mmd file and executing the render.mjs script. This process uses Node.js to apply customizable themes and produce SVG outputs suitable for documentation and design reviews.

Can I batch render multiple Mermaid diagrams in parallel?

Yes, batch rendering processes multiple Mermaid diagrams in parallel to accelerate pipeline execution. This functionality automates the conversion of multiple diagram files into SVG or ASCII outputs simultaneously.

Does this Mermaid rendering approach support ASCII output for terminal workflows?

Yes, this approach supports rendering Mermaid diagrams as ASCII art. It provides configurable output options and background or foreground colors specifically formatted for terminal workflows.

What themes are available when formatting Mermaid diagrams?

This rendering process supports 15 distinct themes and 5 diagram types. You can apply these themes during the rendering step to customize the visual output of your SVG or ASCII architectural diagrams.

Do I need Node.js to render Mermaid diagrams with theming?

Yes, Node.js is required because the rendering logic relies on the beautiful-mermaid library. This dependency enables loading the library, applying themes, and generating SVG or ASCII outputs.

What is the best way to customize colors for Mermaid SVG outputs?

The best way to customize colors is by applying theme settings and specifying background and foreground colors during the rendering step. This configuration produces SVG outputs with your desired color scheme.