核心用法
baoyu-markdown-to-html 是一款专为中文内容创作者设计的 Markdown 到 HTML 转换工具，由 JimLiu 开发维护。其核心定位是解决微信公众号、知乎等平台对 HTML 格式的特殊要求，同时保持 Markdown 的简洁写作体验。用户通过 CLI 调用 main.ts 脚本，指定输入文件与主题参数即可完成转换。
工具采用 Bun/NPX 运行时，支持四级主题（default/grace/simple/modern）和 13 种配色预设，内置代码高亮（Prism）、数学公式（KaTeX）、Mermaid/PlantUML 图表、脚注、警示框等完整 Markdown 扩展语法。特色功能"微信外链转底部引用"（--cite）可将普通外链转为上标编号并在文末统一列出，同时智能保留微信公众号原生链接的直接跳转。
显著优点
1. 平台适配优化：针对微信公众号外链屏蔽政策设计底部引用机制，兼顾合规性与阅读体验
2. 零配置开箱即用：内置四款精致主题与完整中文字体回退方案，无需手动调 CSS
3. 中文内容增强：前置检测 CJK 内容并建议调用 baoyu-format-markdown 修复标点加粗、中西文间距等常见问题
4. 安全沙箱执行：TypeScript 源码在 Bun 运行时中执行，无系统级权限要求
潜在局限
- 依赖 Bun/Node 环境，Windows 用户需额外配置
- 主题扩展需通过 EXTEND.md 文件，无可视化配置界面
- 图片处理仅生成占位符信息，不自动上传 CDN 或压缩
适合人群
公众号运营者、技术博客作者、知识付费内容生产者，以及需要将 Markdown 批量转换为平台兼容 HTML 的编辑工作流。
常规风险
输入文件路径需严格校验防止目录遍历；HTML 输出包含内联 CSS 与 JS，若来源 Markdown 包含恶意脚本可能被带入，建议对不可信来源的 Markdown 开启内容过滤。