Your diagrams deserve more than one gray theme.
zombie-mermaid renders Mermaid syntax into beautiful SVG or ASCII art — with 15 live-switchable themes, animated edges, and zero re-renders, right where AI-assisted coding happens.
Pick a theme. Switch it live — no re-render.
Every one of the 15 built-in themes is just --bg, --fg, and --accent. The diagram reads them live — no re-render, ever.
:root {
--bg: #282a36;
--fg: #f8f8f2;
--accent: #bd93f9;
}
mermaid.js → beautiful-mermaid → zombie-mermaid
What zombie-mermaid adds on top.
beautiful-mermaid already solved mermaid.js's biggest problems — aesthetics, theming, terminal output, dependencies. This fork keeps all of that, and adds three things beautiful-mermaid never had.
A real CLI binary
beautiful-mermaid never shipped one. Pipe Mermaid source in, get SVG or ASCII out, straight from the command line.
mergeEdges
No beautiful-mermaid equivalent. Bundles fan-out/fan-in edges into a shared trunk instead of a tangle of parallel lines.
Real bugs, actually fixed
Mermaid syntax beautiful-mermaid shipped with — dropped edges, corrupted labels, stray nodes — found and fixed, with the before/after code to prove it.
Three ways this stays out of your way.
(Theming and the fork's backstory are covered above — this is what you actually build with.)
Output flexibility
Dual output. SVG for rich UIs, ASCII/Unicode for terminals — mermaid.js itself has no real terminal story.
Mono mode. Full diagrams rendered from just two colors, when that’s all you’ve got.
Drop-in architecture
Zero DOM dependencies. Pure TypeScript. Works in the browser, on the server, or anywhere else.
Synchronous rendering. No async, no flash of unstyled diagram — drops straight into React’s useMemo().
Proven at scale
Ultra-fast. Renders 100+ diagrams in under 500ms — fast enough for every diagram in a CI run.
CI-enforced accessibility. Every diagram type ships a role-correct, nameable SVG root — checked in CI, not just claimed.
A real CLI. A real MCP server.
Render from a terminal, a CI pipeline, or hand it straight to your coding agent as a tool call — this isn't a browser-only diagram widget.
CLI
Render SVG, ASCII, HTML, or PNG straight from a script or CI job — themes, direction overrides, and terminal hyperlinks all pass through as flags. Full flag reference →
Your coding agent calls a tool —
render_mermaid_svg({ diagram })
…and gets back a rendered SVG, no browser involved.
MCP server
render_mermaid_svg, render_mermaid_ascii, and a sequence-activation checker, exposed over stdio — embed it, or run zombie-mermaid mcp directly. Shipped to gauge interest, not a finished implementation — the tool surface may still change. Read the MCP docs →
Every shape your system needs to explain itself.
Actively maintained. Not abandoned.
beautiful-mermaid stalled — dozens of open PRs, nothing merged in months. Here's the same fork, measured against the original as of Sep 7, 2026 — see the live dashboard for current numbers.
zombie-mermaid (this fork)
days
since last commit
merged PRs
open PRs
beautiful-mermaid (upstream)
days
since last commit
merged PRs
open PRs