核心功能
baoyu-markdown-to-html 是一款专为中文内容创作者设计的 Markdown 转 HTML 工具,特别针对微信公众号排版进行了深度优化。其核心能力在于将纯文本 Markdown 转换为视觉精美、样式内联的 HTML 文件,可直接复制到富文本编辑器中使用。
显著优点:
1. 多主题系统:提供 default(经典)、grace(优雅)、simple(极简)、modern(现代)四种预设主题,支持自定义主色调和字体,满足不同品牌视觉需求。
2. 丰富的 Markdown 扩展:原生支持代码语法高亮、数学公式(KaTeX)、Mermaid 流程图、PlantUML 图表、GitHub 风格警告框(Alerts)、脚注、Ruby 注音等高级特性。
3. 智能外链处理:独创的 --cite 模式可将普通外部链接自动转为带编号的上标引用,并在文末生成「引用链接」章节,既保持正文整洁又满足微信外链规范;微信公众号链接则保留为可直接点击的直链。
4. 中文内容优化:内置 CJK 内容检测,可联动 baoyu-format-markdown 技能自动修复中英文混排间距、粗体标点解析等排版问题。
5. 灵活配置体系:通过 EXTEND.md 支持项目级、用户级配置,支持与 baoyu-post-to-wechat 等技能共享主题偏好。
潜在局限:
- 依赖 Bun 运行时环境(或需通过 npx 临时安装),对纯 Node.js 环境不够友好
- 主题自定义虽可通过 CSS 变量实现,但深度定制需理解内部样式结构
- 图片处理采用占位符机制,需额外步骤上传至图床
- 数学公式渲染依赖外部字体,部分移动端阅读器兼容性存疑
适合人群:
- 微信公众号运营者与内容创作者
- 技术博主需要发布含代码、图表的教程文章
- 企业内部知识库维护者
- 对排版有较高要求的 Markdown 写作者
常规风险:
该工具为纯本地转换器,不触及网络 API 或用户敏感数据,安全风险极低。主要注意点在于:转换后的 HTML 若含外部脚本(实际输出为纯静态内联 CSS,无此问题)、以及 --cite 模式生成的外部链接需自行确保目标网址安全性。