核心功能
baoyu-markdown-to-html 是一款专为内容创作者设计的 Markdown 转 HTML 工具，主打微信公众号兼容性与视觉美化。其核心能力包括：
转换能力
- 多主题系统：提供 default（经典）、grace（优雅）、simple（极简）、modern（现代）四种预设主题，支持自定义主色调与字体
- 丰富特性支持：代码语法高亮、数学公式（KaTeX）、Mermaid/PlantUML 图表、脚注、警告块、注音文字等
- 微信专项优化：微信外链自动转为底部引用格式，避免外链被折叠，同时保留微信域内链接的直接跳转
工作流程
1. 中文预处理（可选）：检测 CJK 内容后建议调用 baoyu-format-markdown 修复格式问题
2. 主题解析：按优先级读取 EXTEND.md 配置或交互确认
3. 执行转换：通过 Bun 运行时调用 TypeScript 主脚本
4. 结果输出：生成同目录 HTML 文件，自动备份冲突文件，返回结构化 JSON
显著优点
- 即开即用：内置微信适配样式，无需手动调整 CSS
- 高度可配置：支持通过 EXTEND.md 实现项目级/用户级默认配置
- 跨技能协同：与
baoyu-format-markdown、baoyu-post-to-wechat形成排版-发布工作流 - 内容安全：纯本地转换，无云端依赖，敏感内容不上传
局限性与注意事项
- 运行依赖：需要 Bun 或 npx 环境，Windows 用户需额外配置
- 主题限制：四种预设主题覆盖常见场景，重度定制仍需手写 CSS
- 链接处理：
--cite模式对复杂嵌套链接的识别可能存在边界情况 - 图片处理：仅生成占位符路径映射，图片上传需配合其他工具
适合人群
- 微信公众号运营者、知识付费内容创作者
- 需要将技术文档（含代码、公式、图表）发布到富文本平台的开发者
- 追求排版一致性、厌倦手动调样式的 Markdown 重度用户
常规风险
- 备份机制：转换前自动备份同名 HTML 文件，但仍建议版本控制
- 主题兼容性：部分高级 CSS 特性在旧版微信客户端可能渲染异常
- 依赖稳定性：Bun 生态较新，长期维护需关注上游更新