lukilabs/beautiful-mermaid

Health v2 · maintenance only

Adoption not part of the score

10976 stars · 391 forks observed · 2026-08-28

What it is AI-extracted, prompt v1, taxonomy v1, 2026-08-29, confidence not recorded

A TypeScript library that renders Mermaid diagram syntax as polished SVG or ASCII/Unicode art, with zero DOM dependencies and synchronous rendering. It supports six diagram types, 15 built-in themes, and Shiki theme compatibility.

Use cases

• render mermaid diagrams as svg in a web app
• display flowcharts as ascii art in a terminal
• visualize diagrams inside an AI coding assistant chat
• theme mermaid diagrams with a VS Code theme
• render diagrams synchronously in React with useMemo
• generate sequence and ER diagrams without a browser DOM

When to choose

• you need fast, dependency-light Mermaid rendering in Node, Bun, or the browser
• you want terminal-friendly ASCII output for CLI tools
• you need deep theming control or Shiki/VS Code theme compatibility
• you want synchronous rendering without async flashes in UIs

When to avoid

• you need diagram types beyond flowchart, state, sequence, class, ER, or XY charts
• you rely on Mermaid's full feature set or interactive features
• you need a pure client-side drop-in replacement for mermaid.js with identical output

Facets

library · maturity active

data-visualization templating developer-tools data-visualization documentation bun cli cross-platform mermaid diagram-rendering svg ascii-art theming zero-dom-dependencies typescript nodejs

Member repositories

For agents

markdown · JSON · MCP: product_card(name="lukilabs/beautiful-mermaid")