Baoyu Markdown To Html

将 Markdown 转换为微信兼容的样式 HTML,支持代码高亮、数学、PlantUML、脚注、提示框、信息图及可选机器人。

安装

概览

Baoyu Markdown To Html 是一款专为微信公众号等中文内容平台优化的 Markdown 转 HTML 工具。它能将标准的 Markdown 文件转换为美观且兼容微信阅读体验的网页格式,采用内联 CSS 样式确保在不同设备上的一致性显示。该工具支持丰富的 Markdown 扩展语法,包括代码高亮、数学公式、流程图(Mermaid)、时序图(PlantUML)、脚注、提示框等多种富文本元素,极大提升了技术文档和长文排版的表现力。 除了基础的转换功能外,Baoyu 提供了高度可定制的主题系统,包含经典、优雅、简约和现代四种风格,每种主题都经过精心设计以适应不同的视觉偏好和内容类型。用户可以通过命令行参数或配置文件自由切换主题,并进一步调整主色调、字体族、字号等细节设置,实现个性化输出效果。特别针对中文排版优化,内置多种预设颜色方案,如传统中国红、典雅蓝等,让生成的文章更具文化氛围。 工具还支持元数据提取与处理,自动识别 YAML 格式的 frontmatter 信息(如标题、作者、摘要),并可根据需要将原始 Markdown 中的第一个标题保留在正文中或移除。对于外部链接,启用 `–cite` 参数后可将普通外链转为文末编号引用形式,符合微信生态的内容规范,提升专业度与可读性。

核心功能特点

  1. 支持完整的 Markdown 语法及扩展:含代码高亮、数学公式、Mermaid/PlantUML 图表、脚注、提示框等
  2. 提供四种精美主题:经典、优雅、简约、现代,均适配中文排版习惯并支持自定义配色
  3. 智能处理外部链接:可选将普通外链转为文末引用链接,保留公众号链接直连
  4. 灵活配置选项:支持覆盖标题、指定字体、调整字号、备份原文件等功能
  5. 自动提取元数据:从 frontmatter 或内容中提取标题、作者、摘要等信息
  6. 跨平台运行:基于 Bun 运行时,兼容 macOS、Linux、Windows(WSL/Git Bash/PowerShell)

适用场景

Baoyu Markdown To Html 特别适合需要高质量排版输出的中文内容创作者和技术写作者。无论是撰写技术教程、产品说明文档还是个人博客文章,都可以借助此工具快速生成符合微信公众平台要求的 HTML 文件,无需手动编写复杂样式即可实现专业级视觉效果。尤其适用于包含大量代码片段、流程图或数学表达式的理工科类文章,其内置的高亮引擎和图表渲染能力能显著提升信息传达效率。 对于运营人员而言,该工具是制作公众号图文素材的理想选择——只需用 Markdown 编写内容,再通过简单命令即可一键生成可直接上传至后台的文章页面,节省大量排版时间。配合 `–cite` 参数使用,还能自动整理参考文献链接,增强内容的权威性和可信度。此外,支持自定义主题和配色方案的特点,使得同一份内容可以轻松适配不同品牌调性或节日专题需求,保持视觉风格统一的同时又不失灵活性。 开发者和设计团队也可利用 Baoyu 快速产出内部培训材料、API 文档或项目汇报幻灯片,结合 PlantUML 绘制架构图、Mermaid 制作状态机模型等功能,使技术沟通更加直观高效。由于输出为纯静态 HTML,便于嵌入网站、邮件客户端或其他第三方平台,具备良好的通用性和兼容性。