将 Markdown 转为微信兼容的精美 HTML,支持代码高亮、数学公式、Mermaid 图表渲染及外链底部引用,适合公众号排版发布。
说明:
## 核心用法
`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,否则降级为 `
` 代码块
- **Bun 运行时**:需预先安装 `bun` 或借助 `npx`,对纯 Node 环境不够友好
- **中文预检门槛**:自动提示格式化可能打断批量处理流程### 适合人群
微信公众号运营者、技术博主、知识付费内容生产者,尤其需要将 Markdown 源稿快速转为可发布 HTML 且对排版美观度有要求的场景。### 常规风险
- **外链转换**:开启 `--cite` 后,非微信域名链接被移至底部,需确认引用完整性
- **图片路径**:Mermaid 缓存目录默认位于 `imgs/.mermaid-cache/`,需手动加入 `.gitignore` 防止误提交









