跳转到使用指南
Baoyu Markdown to HTML作者 jimliu

Baoyu Markdown to HTML Skill.

将 Markdown 转成已排版、适合文章发布的 HTML。

  • Markdown
  • 文章排版
源文件解读 · baoyu-markdown-to-htmlSKILL.md
任务 将 Markdown 转成已排版、适合文章发布的 HTML。 产出 使用内联 CSS、应用指定主题的 HTML 文件。 开始前的准备 这款 Skill 负责生成 HTML;发布文章是另一个独立操作。
编辑摘要 · 源文件核查于 2026-11-02 · 非生成示例

01 功能说明

将 Markdown 转成已排版、适合文章发布的 HTML

将 Markdown 转成带主题和内联 CSS 的 HTML,支持代码、图表及可选的外链引用,适用于微信公众号文章工作流。

基于来源的工作流并非执行基准测试

工作方法

Baoyu Markdown to HTML 将文章转换为带有内联 CSS、已完成排版的 HTML,并针对微信公众号工作流进行优化。除了主题和字体排版选项,它还支持代码高亮、脚注、提示块和图表。转换后的 HTML 保存在 Markdown 源文件旁;如果已有 HTML 输出,则先创建带时间戳的备份。

这款 Skill 还处理影响最终文章的发布细节。默认会移除第一个标题,除非启用 keep-title;只有明确要求时,外部链接才会转为文末引用。Mermaid 图表通过浏览器渲染成缓存的 PNG 素材;无法渲染时则回退为文本形式。

预期交付物

  • 使用内联 CSS、应用指定主题的 HTML 文件。
  • 生成或引用的图片信息,包括渲染成功时产生的 Mermaid PNG 素材。
  • 包含 HTML 路径及备份路径(如有)的结构化结果。
查看示例简报

从简报到审查

  1. 01
    确定文章的呈现方式

    读取明确指定的主题和 EXTEND.md 偏好。如果输入包含中日韩文字,且 baoyu-format-markdown 可用,则在转换前提供这一步独立的格式整理选项。

  2. 02
    选择引用与标题的处理方式

    除非用户要求,否则保持外链引用关闭。确定是否在文章正文中保留开头的标题。

  3. 03
    转换内容和图表

    使用 Bun 或文档说明的 npx 备用方式运行随附的 main.ts 转换器,并传入选定的呈现选项。条件允许时,Mermaid 会通过浏览器渲染 PNG,并利用缓存。

  4. 04
    检查发布用的输出

    打开 HTML、检查图表,并报告结果路径。区分成功生成的图片与回退显示的 Mermaid 标记文本。

02 适用场景

适合什么场景

这款 Skill 负责生成 HTML;发布文章是另一个独立操作。

适合的场景

  • 导出排版文章需要将 Markdown 文章转成使用内联 CSS 的 HTML,接入发布工作流。
  • 微信公众号排版内容需要兼容的主题,并可选择将外部参考链接集中整理。

需要检查的限制

  • 只负责转换这款 Skill 负责生成 HTML;发布文章是另一个独立操作。
  • 图表渲染依赖浏览器将 Mermaid 渲染为 PNG 需要 Chrome、Chromium 或 Edge。
  • 转换成功不代表图表渲染成功整体转换可能成功,但图表仍以回退的标记文本显示,因此需要检查结果。

请提供这些输入

  • Markdown 源文件提供文章及其中引用的本地图片。
  • 呈现选项选择主题,并按需自定义颜色、字体或标题。
  • 发布相关处理说明引用模式、是否保留标题,以及图表需求。

03 关键决策

影响结果的关键选择

  1. 适合文章使用的样式

    内联 CSS 将所选主题带入导出的文档。

  2. 明确处理链接

    文末引用需要主动开启,文档也说明了微信链接和裸 URL 的例外处理。

  3. 可恢复的输出

    替换已有 HTML 前,会先创建带时间戳的备份。

04 示例任务

从一份具体的需求开始

以下示例任务说明尚未经过测试。使用前请检查该技能的设置。

查看源文件和环境要求

提供文章及其中引用的本地图片。

上游源文件
https://github.com/jimliu/baoyu-skills/blob/0a27d7d40e79cfe42334e2e9130a1e41a499ca54/skills/baoyu-markdown-to-html/SKILL.md

下方链接会打开上游使用说明。使用前请查看仓库的环境配置要求;这不是安装命令。

先完成一项明确的交付物

运行该技能之前,请根据需要调整此需求中的范围、来源材料和约束。

示例简报
使用 baoyu-markdown-to-html,以 simple 主题和我们选定的强调色转换提供的文章。保留第一个标题,并将普通外链转为文末引用。不要修改 Markdown 源文件。文章包含两个 Mermaid 图表,请尝试渲染为 PNG,并检查输出中是可用图片还是回退的标记文本。报告 HTML 路径、备份路径(如有)和生成的图表素材。不要发布文章。指出进入发布工作流前需要处理的不支持的格式或缺失的本地图片。

检查结果

根据以下可观察标准检查实际输出。

  • HTML 符合指定的主题和标题处理要求。
  • 实际检查图表,而不是根据转换成功退出就推断图表正常。
  • 准确报告输出与备份路径。

OpenDesign 为编码智能体提供本地设计工作区。此条目并不表示该技能已内置,也不表示其中包含其外部工具、凭据和软件依赖项。

05 来源与许可证

来源与许可证

本页面描述的是下方链接所指向的固定来源修订版本。上游行为和要求可能会发生变化。

来源所有者
jimliu
技能文件
SKILL.md
许可证
MIT
已审查的快照
2026-11-02 · 0a27d7d40e79

阅读说明

  1. 许可证适用范围已核实固定版本仓库中的 LICENSE 文本;检查完整归档的文件名清单后,未在该 Skill 路径下发现更具体的 LICENSE、COPYING 或 NOTICE 文件。此分类适用于所审查的上游源代码,不涵盖生成结果或第三方依赖。README 说明,除另有注明外,GitHub 仓库采用 MIT,而发布到 ClawHub 的分发版本采用 MIT-0;本条目按固定版本的 GitHub 源代码分类。相关转换器代码的 packages/baoyu-md/src/LICENSE 中,对改编自 doocs/md 的代码标明了 WTFPL Version 2。不要将整个依赖包统一标记为 MIT。
编辑来源摘要
将 Markdown 转成已排版、适合文章发布的 HTML。

由 OpenDesign 根据所链接来源撰写的原创摘要。仓库星标数只是带有时间属性的受欢迎程度指标,并不代表技能使用量或质量评分。

06 开始前的问题

开始前可能想问

外部链接总会移到文末吗?

不会。引用模式默认关闭,仅在明确要求时开启。

Mermaid 渲染失败会怎样?

转换器可以回退为预格式化的 Mermaid 标记文本,同时整体转换仍然成功。

它会替换已有的 HTML 文件吗?

源文件说明,替换前会先创建带时间戳的备份,并报告其路径。

OpenDesign

让需求和设计工作保存在一起。

将简报、来源材料和设计工作集中保存在本地工作区中。将该技能添加到工作流程前,请检查其自身的设置说明。

上游源文件
https://github.com/jimliu/baoyu-skills/blob/0a27d7d40e79cfe42334e2e9130a1e41a499ca54/skills/baoyu-markdown-to-html/SKILL.md