核心功能
baoyu-markdown-to-html 是一款专为中文内容创作者设计的 Markdown 到 HTML 转换工具，深度优化微信公众号等平台的排版需求。核心能力包括：
- 多主题渲染：提供 default（经典）、grace（优雅）、simple（极简）、modern（现代）四种预设主题，支持自定义主色调（13 种预设色）和字体
- 丰富 Markdown 扩展：完整支持代码高亮、数学公式（KaTeX）、Mermaid/PlantUML 图表、脚注、警示块、注音（Ruby text）等
- 微信生态优化：专为微信公号设计的
--cite模式，将外部链接自动转为底部编号引用，保留微信域名直链，规避外链限制 - 智能预处理：检测中文内容时可选调用
baoyu-format-markdown进行格式优化，修复标点加粗、中西文间距等常见问题
显著优点
1. 平台适配性强：输出为内联 CSS 的独立 HTML，完美兼容微信编辑器、知乎、掘金等富文本平台
2. 高度可定制：通过 EXTEND.md 支持项目级、用户级的默认配置，支持自定义 CSS 变量
3. 开发者友好：基于 Bun 运行时构建，TypeScript 编写，支持 JSON 结构化输出便于二次集成
4. 安全冗余设计：自动备份已存在的 HTML 文件，避免覆盖损失
潜在局限
- 运行时依赖：必须安装 Bun 或 Node.js（通过 npx），Windows 用户需额外配置
- 中文内容优先：部分优化（如格式化预处理）仅针对 CJK 内容触发，纯英文场景功能冗余
- 主题扩展性有限：新增自定义主题需修改源码，非配置化扩展
适合人群
- 微信公众号运营者、技术博主、知识付费创作者
- 需要将技术文档（含代码、图表、公式）发布到不支持原生 Markdown 平台的开发者
- 对排版美学有要求的内容团队
常规风险
- 转换复杂 Markdown（嵌套表格、极端嵌套引用）时可能出现渲染偏差，建议大文件先行预览
- 外链引用模式依赖正则解析，非标准 Markdown 链接语法可能识别失败
- 图片路径处理为本地绝对路径，跨平台迁移 HTML 文件时需注意资源引用
- 数学公式渲染依赖 KaTeX，复杂 LaTeX 宏可能不支持