核心用法
baoyu-markdown-to-html 是一款专为中文内容创作者设计的 Markdown 转 HTML 工具，核心功能是将 Markdown 文件转换为带有内联 CSS 的美观 HTML 页面，特别优化了微信公众号等平台的展示效果。
使用流程
1. 前置检查（中文内容可选）：检测 CJK 字符，建议先用 baoyu-format-markdown 格式化
2. 主题选择：支持 default、grace、simple、modern 四种预设主题，支持自定义颜色和字体
3. 引用模式（可选）：将普通外链转换为文末编号引用（微信链接保持原样）
4. 执行转换：通过 Bun 运行 TypeScript 脚本生成 HTML
5. 结果报告：输出 JSON 包含文件路径、备份信息、图片占位符等
显著优点
- 微信生态深度适配：专为公众号设计，支持外链转底部引用避免被折叠
- 丰富的 Markdown 扩展：支持代码高亮、数学公式（KaTeX）、Mermaid/PlantUML 图表、脚注、提示块、注音等
- 多主题系统：4 种精心设计的主题，12 种预设配色，支持自定义 CSS 变量
- 智能冲突处理：自动备份同名 HTML 文件，生成带时间戳的备份
- 跨平台支持：Bun/npx 双运行时，Windows/macOS/Linux 全兼容
- 灵活配置：通过 EXTEND.md 实现项目级/用户级默认配置
潜在缺点与局限性
- 运行时依赖：需要安装 Bun 或 Node.js + npx，非纯本地二进制工具
- 中文内容优化前置：建议配合格式化工具使用，否则中文排版可能存在问题
- 主题定制门槛：自定义 CSS 需理解 CSS 变量体系，对非技术用户有一定门槛
- WeChat 特定功能：外链转引用、微信链接识别等功能对其他平台价值有限
- 无实时预览：需生成后手动查看 HTML，无内置预览服务器
适合人群
- 微信公众号运营者：需要美观排版、外链处理的图文创作者
- 技术博主：需要代码高亮、图表、数学公式的技术内容作者
- 文档工程师：需要批量生成样式化 HTML 文档的团队
- 内容排版人员：追求视觉一致性，希望 Markdown 一键转精美 HTML 的用户
常规风险
- 备份机制虽存在但仍可能丢失：极端情况下备份文件可能覆盖或磁盘满
- EXTEND.md 配置优先级复杂：多级配置（项目/用户/XDG）可能导致预期外行为
- 跨技能依赖：与
baoyu-format-markdown、baoyu-post-to-wechat存在隐性耦合 - Bun 生态较新：相比 Node.js，Bun 的长期稳定性仍在验证中
技术亮点
- 采用 Bun 运行时获得更快的执行速度
- 智能运行时回退：Bun → npx bun → 提示安装
- JSON 结构化输出便于下游自动化处理