功能概述
baoyu-markdown-to-html 是一款专为中文内容创作者设计的 Markdown 转 HTML 工具，核心定位是微信公众号排版优化。与通用转换器不同，它深度适配了国内平台（尤其是微信）的渲染特性，提供四种预设主题（classic/grace/simple/modern）和丰富的视觉定制选项。
核心用法
1. 基础转换：bun scripts/main.ts article.md，自动生成同目录 HTML 文件
2. 主题定制：通过 --theme 选择风格，--color 支持 12 种预设色或自定义 HEX
3. 微信外链优化：--cite 模式将普通外链转为文末编号引用，符合微信图文规范
4. 前置格式化：检测到中文内容时，可选调用 baoyu-format-markdown 修复标点加粗、中西文间距等常见排版问题
显著优点
- 微信生态深度适配：内置四种主题均针对移动端阅读优化，modern + red 配色可直接生成「中国红」传统风格
- 扩展语法丰富：原生支持 Mermaid/PlantUML 图表、数学公式、脚注、高亮块（Alerts）、Ruby 注音等，超越标准 Markdown
- 配置层级灵活：支持项目级、用户级、XDG 规范三级 EXTEND.md 配置，便于团队协作与个人习惯分离
- 智能备份机制：输出冲突时自动创建时间戳备份，避免误覆盖
- 中文排版预处理：可选集成格式化技能，解决 CJK 与英文混排的典型问题
潜在局限
- 运行时依赖 Bun：虽提供 npx 降级方案，但 Bun 仍是首选运行时，Windows 环境配置略复杂
- 主题系统封闭：自定义 CSS 需通过 EXTEND.md 的 CSS 变量注入，无法直接覆盖模板结构
- 微信外链识别硬编码：仅
mp.weixin.qq.com保留直链，其他域名统一转为引用，缺乏白名单配置 - 无实时预览：需生成后手动打开 HTML 查看效果，调试样式成本较高
适合人群
- 微信公众号、知乎专栏、个人博客的内容运营者
- 需要将技术文档（含代码、图表、公式）转为移动端友好格式的开发者
- 对排版细节有要求、希望「一次写完、多处发布」的 Markdown 重度用户
常规风险
- Bun 生态成熟度：Bun 虽快但版本迭代激进，建议锁定
1.56.1配套版本 - HTML 文件体积：内联 CSS 与语法高亮样式可能导致单文件 100KB+，需注意微信图文大小限制
- 图片路径处理：本地图片转为占位符后需手动上传图床替换，流程未完全自动化