okooo5km

okooo5km / beautiful-mermaid-cli

Public

Render Mermaid diagrams as beautiful SVG/PNG/ASCII from the command line.

16
0
100% credibility
Found Apr 29, 2026 at 16 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
TypeScript
AI Summary

A tool that converts Mermaid diagram text into attractive SVG images, PNG pictures, or ASCII art with customizable themes from the command line.

How It Works

1
🔍 Find the diagram maker

You discover a handy tool that turns simple text descriptions into beautiful pictures like flowcharts or graphs.

2
📥 Get it on your computer

You quickly add the tool to your computer so it's always ready when you need it.

3
✏️ Describe your idea

You write a plain text sketch of your diagram, like boxes connected by arrows.

4
🎨 Create the pretty version

You pick a colorful style and watch your text transform into a stunning visual diagram.

5
💾 Save your picture

You choose to save it as a crisp image or fun text art for your documents or notes.

✨ Impress everyone

Your professional-looking diagram is ready to share in reports, websites, or with friends, making complex ideas easy to understand.

Sign up to see the full architecture

4 more

Sign Up Free

Star Growth

See how this repo grew from 16 to 16 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is beautiful-mermaid-cli?

Beautiful-mermaid-cli is a TypeScript CLI for rendering Mermaid diagrams as polished SVG, PNG, or ASCII output directly from the terminal. It lets you turn Mermaid syntax into visuals locally—no browser or heavy dependencies needed—handling inputs from files, stdin, or inline code with commands like `bm diagram.mmd -o out.svg` or `bm ascii diagram.mmd`. Powered by a pure JS stack on Node 20+ or Bun, it supports rendering Mermaid diagrams locally, to PNG, or even ASCII for quick previews.

Why is it gaining traction?

It stands out with 15 built-in themes, color overrides, and options like scale or padding, producing outputs ready for GitHub Markdown, Obsidian, or VSCode without online tools. The JSON mode and stable exit codes make it AI-agent friendly for automated rendering of private GitHub repos or tests, while doctor checks your env for fonts and WASM. No Puppeteer or native builds means fast installs via npm, npx, or Homebrew.

Who should use this?

CLI enthusiasts scripting diagram generation for docs or reports. Devs rendering Mermaid in Markdown for GitHub education labs, private repos, or local HTML. AI tool builders needing offline Mermaid-to-PNG/SVG without web services, or Obsidian/VSCode users wanting beautiful Mermaid clipart without plugins.

Verdict

Try it for local Mermaid rendering if you hate online tools—solid features and agent-ready JSON outweigh the early maturity (16 stars, 1.0% credibility). Docs are clear, tests run via Vitest, but low adoption means test thoroughly before production.

(198 words)

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.