Baoyu Markdown To Html

核心用法

baoyu-markdown-to-html 是一款专为内容创作者设计的 Markdown 转 HTML 工具，主打微信公众号排版优化。用户通过 CLI 命令或对话触发，输入 Markdown 文件即可获得内嵌 CSS 的独立 HTML 文件，直接复制粘贴即可使用。

主要功能

• 多主题切换：提供 default、grace、simple、modern 四种视觉风格，支持自定义主色调与字体
• 代码与图表：集成语法高亮、Mermaid 流程图（通过无头 Chrome 渲染为 PNG 缓存）、PlantUML、数学公式
• 微信专项优化：外链可自动转为文末「引用链接」编号列表，避免微信内链被拦截；支持注音拼音 {base|annotation}
• 智能预处理：检测中文内容时提示调用 baoyu-format-markdown 修复标点加粗解析、中西文间距等问题

显著优点

• 开箱即用：生成单文件 HTML，CSS 内联无需外部依赖
• 缓存机制：Mermaid 图表按代码哈希缓存，重复渲染秒级完成
• 灵活配置：通过 EXTEND.md 支持项目级、用户级配置覆盖

潜在局限

• 依赖 Chrome：Mermaid 转 PNG 需本地安装 Chrome/Chromium/Edge，否则降级为 <pre> 代码块
• Bun 运行时：需预先安装 bun 或借助 npx，对纯 Node 环境不够友好
• 中文预检门槛：自动提示格式化可能打断批量处理流程

适合人群

微信公众号运营者、技术博主、知识付费内容生产者，尤其需要将 Markdown 源稿快速转为可发布 HTML 且对排版美观度有要求的场景。

常规风险

• 外链转换：开启 --cite 后，非微信域名链接被移至底部，需确认引用完整性
• 图片路径：Mermaid 缓存目录默认位于 imgs/.mermaid-cache/，需手动加入 .gitignore 防止误提交

核心功能

baoyu-markdown-to-html 是一款专为内容创作者设计的 Markdown 转换工具，主要面向微信公众号等平台的排版需求。它不仅能将标准 Markdown 转换为内嵌 CSS 的独立 HTML 文件，还提供了丰富的扩展功能，包括代码高亮、数学公式渲染、Mermaid 流程图（通过 headless Chrome 渲染为 PNG）、PlantUML 图表、脚注、警示块（Alerts）等高级特性。

显著优点

1. 微信生态深度适配

• 内置四种精美主题（default/grace/simple/modern），支持自定义配色和字体
• 独有的「外链转底部引用」功能（--cite），可将普通外部链接自动转为文末编号引用，同时保留微信公众号链接的直接跳转
• 针对中文内容优化，支持 Ruby 注音、CJK/英文间距处理等排版细节

2. 图表渲染能力突出

• Mermaid 图表通过 headless Chrome 实时渲染为高清 PNG，支持缓存和多种主题
• PlantUML 原生支持，无需额外配置
• 图表渲染参数精细可调（缩放比例、目标宽度、背景色等）

3. 工程化设计

• 支持 EXTEND.md 配置文件，实现项目级、用户级配置分层管理
• 智能备份机制，避免覆盖原有文件
• JSON 结构化输出，便于下游流程集成

潜在局限

1. 运行时依赖

• 必须安装 Bun 或通过 npx 运行，对纯 Node.js 环境用户不够友好
• Mermaid 渲染依赖本地 Chrome/Chromium/Edge，无浏览器环境时降级为代码块

2. 功能边界

• 纯转换工具，不涉及发布环节（需配合 baoyu-post-to-wechat 等技能）
• 不支持实时预览，需生成后手动查看效果

3. 生态封闭性

• 依赖作者自研的 baoyu-md 和 baoyu-chrome-cdp 包，而非社区主流方案

适合人群

• 公众号运营者：需要将技术文档、教程内容转换为微信兼容格式
• 开发者/技术博主：撰写包含代码、图表的技术文章
• 内容团队：需要统一排版风格和引用规范的内容生产流程

常规风险提示

| 风险项 | 等级 | 说明 |

|--------|------|------|

| 依赖安全 | 低 | 仅 2 个自研依赖，无已知 CVE |

| 供应链攻击 | 极低 | MIT-0 开源协议，代码可审计 |

| 隐私泄露 | 极低 | 纯本地处理，无云端上传 |

| 浏览器调用 | 低 | Chrome CDP 仅用于本地渲染，无网络外联 |