baoyu-markdown-to-html · 把 Markdown 排成公众号文章

作者提供的示例，实际效果取决于你的输入和使用工具。

输入

原文：标题“上传前检查”；提示“保留原图，再压缩副本”；选择简洁主题；本例仅给片段。

输出

编辑示例 · 未运行

<section style="font-size:16px;line-height:1.8;color:#222;">
  <h2 style="font-size:22px;margin:24px 0 12px;">上传前检查</h2>
  <blockquote style="margin:12px 0;padding:12px 16px;border-left:3px solid #6655cc;background:#f5f4fb;">
    保留原图，再压缩副本。
  </blockquote>
</section>

平台核对：标题没有重复出现，提示块边框仍可见，中文换行正常；这段是编辑示例，不是已完成转换文件。

把 Markdown 文章转成带样式的 HTML，处理标题、代码和引用，方便继续放进公众号编辑流程。

具体任务

把 Markdown 转成公众号兼容 HTML：按主题保留标题、代码、公式和必要图片，并输出内联样式。

核对外链引用与平台粘贴效果：根据选项处理外链为底部引用，检查平台实际预览。

必需材料

Markdown 原文文件

主题及公式/图表/外链处理要求

可选材料

标题保留规则

品牌颜色与字体偏好

使用门槛

完整转换目录和运行时可用，复杂图表所需工具已确认。

这个 Skill 额外提供的方法

把文章内容与发布平台样式衔接起来，同时保留源稿可继续编辑。

编辑示例（未运行）

把一个操作提示块转成内联样式

任务：展示转换成品中可见的 HTML 结构。

输入：
原文：标题“上传前检查”；提示“保留原图，再压缩副本”；选择简洁主题；本例仅给片段。

结果片段：
```html
<section style="font-size:16px;line-height:1.8;color:#222;">
  <h2 style="font-size:22px;margin:24px 0 12px;">上传前检查</h2>
  <blockquote style="margin:12px 0;padding:12px 16px;border-left:3px solid #6655cc;background:#f5f4fb;">
    保留原图，再压缩副本。
  </blockquote>
</section>
```

平台核对：标题没有重复出现，提示块边框仍可见，中文换行正常；这段是编辑示例，不是已完成转换文件。

用实际 HTML 展示输出形态，不把截图或发布状态当成转换能力。 此为编辑示例，未安装或运行上游 Skill。

首次任务

将【Markdown 文件】按【主题/公式图表外链要求】转 HTML；验收：源稿保留、样式内联、图片引用可用，公众号粘贴预览单独记录，不发布。
必需材料：Markdown 原文文件：【请填写或粘贴】；主题及公式/图表/外链处理要求：【请填写或粘贴】

验收方法

标题处理是否符合要求且无重复

公式、图表、脚注和外链是否完整

平台预览与本地 HTML 是否有差异

依赖与准备

固定版本 Bun 与完整脚本目录；Mermaid 转图可需 headless Chrome，其他图表/公式按上游依赖配置。

使用边界

转换完成不代表已经发布公众号。

平台可能处理外链、公式和图片，必须粘贴后预览而非只看本地 HTML。

排错

复制后公式或图表消失：检查是否已转为平台可用图片，以及图片路径是否可访问。

首个标题被转换器移除：核对保留首标题选项和文章元数据，避免双重标题或误删。

固定来源

https://github.com/JimLiu/baoyu-skills/blob/1567581c26ec29f4216c6e6835415bf30343b0e3/skills/baoyu-markdown-to-html/SKILL.md

先看看示例

输入

输出

方法说明