用途:该技能帮助在 Node、浏览器或 CLI 环境中,使用 beautiful-mermaid 包快速把 Mermaid 源码渲染为可主题化的图形输出,主要用于生成 SVG 图、ASCII/Unicode 图和统一主题样式。资料未提供安装与具体版本信息。
主要能力:
- 渲染 SVG:用 renderMermaid() 传入 Mermaid 源码,自动识别图类型,可传 bg、fg、accent、transparent、font 等 RenderOptions。
- 渲染终端文本:用 renderMermaidAscii() 输出 Unicode 制表符图;加 useAscii: true 输出纯 ASCII,可用 paddingX、paddingY、boxBorderPadding 调整间距,终端对齐可设 preserveDisplayWidth: true。
- 主题:可用 THEMES 提供的 15 个内置主题;只给 bg + fg 进入单色模式并由 color-mix() 推导其他颜色;也可追加 line、accent、muted、surface、border 覆盖推导值。
- Shiki 集成:用 getSingletonHighlighter 加载 Shiki 主题,再由 fromShikiTheme() 转换后传给 renderMermaid()。
- 浏览器全局包:通过 script 标签加载 https://unpkg.com/beautiful-mermaid/dist/beautiful-mermaid.browser.global.js ,从 beautifulMermaid 取 renderMermaid、THEMES 等。
- 实时换肤:直接更新 SVG 的 CSS 变量(--bg、--fg),无需重新渲染。
必要用法: import { renderMermaid, renderMermaidAscii, THEMES } from 'beautiful-mermaid' const svg = await renderMermaid('graph TD; A-->B', THEMES['tokyo-night']) const ascii = renderMermaidAscii('graph LR; A-->B', { useAscii: true })
适用场景:程序员的 CLI/终端输出图、Web/React 内嵌 SVG、CI 与文档批量渲染 SVG、运营或产品文档导出 SVG、会议汇报统一风格、课程演示终端 ASCII/Unicode、需要与 VS Code 或编辑器主题一致的 Shiki 映射。
限制:需保证 Mermaid 语法正确;浏览器使用前需先加载全局包;终端对齐建议使用 Unicode 或开启 preserveDisplayWidth;资料未提供安装命令、依赖要求、性能数据与定价信息。