beautiful-mermaid-cli

最適合誰

需要在 CI 環境或輕量容器中渲染 Mermaid 圖表、不想背 300MB Chromium 依賴的開發者。需要終端機內 ASCII 圖表預覽的使用者。追求完全離線、無資料外洩風險的場景。不適合需要 Gantt、Mindmap、Git Graph 等進階圖表類型的使用者。

我實際怎麼用

暫作為 mmdc 的互補工具。在終端機中用 bm ascii 快速預覽 Flowchart 和 Sequence Diagram，確認結構正確後再用正式工具渲染高品質輸出。--json 介面的設計理念（schema_version + exit codes）也作為自建 CLI 工具的參考範本。

真正強的地方

• 不需要 Puppeteer 或 Chromium，安裝體積極小
• ASCII 渲染是獨家功能——Unicode box-drawing 字元直接在終端機顯示圖表
• 內建 15 套佈景主題（tokyo-night、catppuccin、nord、dracula 等 Shiki 相容主題）
• --json flag 輸出結構化結果，exit codes 語義明確（0 成功 / 1 WASM 錯誤 / 2 用法 / 3 解析 / 4 I/O），適合 AI agent 整合
• 完全離線運作，無任何網路請求

失敗模式與不該用的情境

• 僅支援 6 種圖表類型（Flowchart / State / Sequence / Class / ER / XY Chart）。Gantt、Mindmap、Git Graph、Pie、Timeline 全部不支援。
• 核心依賴 beautiful-mermaid 使用 latest 無版本鎖定，每次安裝可能拉到不同版本，供應鏈風險高
• 專案極新——首版 2026-04-28，72 小時內發佈 7 版，API 仍在劇變中
• CLI 本身僅 23 Stars，單一貢獻者，社群驗證不足
• PNG 模式不支援 Emoji（resvg-wasm 限制）

價格、上手門檻與風險

• 完全免費，MIT 授權
• 上手門檻極低：npm i -g beautiful-mermaid-cli 或 brew install okooo5km/tap/bm，需 Node.js >= 20
• 風險：核心依賴無版本鎖定是最大隱患；專案 7 天歷史，穩定性未經驗證；第三方 Homebrew tap 由作者獨自維護

結論

概念正確、設計精良的輕量 Mermaid CLI，ASCII 渲染是獨家亮點。但圖表類型覆蓋不足、供應鏈風險高、專案太新，目前僅適合實驗性使用。等 beautiful-mermaid 底層支援更多類型且版本穩定（semver 1.x+）後再正式採用。作為 mmdc 的互補而非取代。

來源

• GitHub: okooo5km/beautiful-mermaid-cli