你大概攒了不少
.md文件。文档、笔记、README、博客草稿，几乎所有文字产物最后都得变成 HTML 才能被人真正看到。问题来了：让 AI Agent 帮你做这件事时，它真的知道怎么转吗，还是当场给你编一套错漏百出的正则？
Smithery 上的 github/markdown-to-html 这个 skill 就是专门解决这件事的。它不教你怎么写 Markdown，而是把”怎么把 Markdown 可靠地翻成 HTML”封装成 Agent 随时能调用的专家知识。本文拆开看看它到底值不值得装。
它到底是什么
一句话：一个基于 marked.js 的 Markdown 转 HTML 专家 skill，采用 Tool Wrapper（工具包装）设计模式。
它干三件事：
-
用 marked.js 把 Markdown 解析成 HTML，这是主路径 -
当你要写自定义转换脚本时，给你 pandoc、gomarkdown/markdown 等工具的选型知识 -
当你在做静态站点或 Jekyll/Hugo 模板系统时，给你对应的转换范式
关键点在于它没把自己锁死在 marked.js 上。SKILL.md 里写得很明白，自定义脚本的知识范围覆盖 pandoc、gomarkdown/markdown 做数据转换，也覆盖 jekyll/jekyll 和 gohugoio/hugo 做模板系统。换句话说，它是”转换领域”的专家，而不只是”marked.js 说明书”。
三件本事背后是三套不同的工具，定位差得很远，别混为一谈：
工作机制
核心路径其实很直白：
表层能力是”调用 marked.js 转”，深层能力是”你要自己造轮子时该用哪个工具”的判断力。比如你要批量处理几百个 .md 文件，marked.js 的 CLI 或 Node API 就够了；但你要保留脚注、目录、复杂数学公式，pandoc 才是正解。这个 skill 的价值，就是让 Agent 在错误工具上栽跟头之前先帮你选对。
它支持三种 Markdown 方言：GFM（GitHub Flavored）、CommonMark，以及标准 Markdown。CLI 和 Node.js 两条工作流都覆盖，单文件、批量转换、进阶配置都接得住。
什么时候该派它上场
SKILL.md 给了一组明确的触发词，基本覆盖你所有”要转 HTML”的场景：
-
“convert markdown to html” 或 “transform md files” -
“render markdown” 想要 HTML 输出 -
从 .md生成 HTML 文档 -
用 Markdown 内容搭静态站 -
给已有模板系统（Jekyll/Hugo）写转换组件 -
只是想预览一下 Markdown 渲染出来长啥样
说白了，只要你的任务里出现”.md 进、HTML 出”这个动作，就该让它上场。
上手成本
安装就一行：
npx skills add https://smithery.ai/skills/github/markdown-to-html
或者用 agentskill.sh 的 /learn @github/markdown-to-html。Smithery 上的安装量是 2 万多（20,589），说明它确实是个被反复验证过的刚需 skill，不是那种挂着好听名字没人用的摆设。
我得泼点冷水：质量审计
agentskill.sh 对这个 skill 做过自动质量评审，打分 67/100（good 档），但暴露了几个实打实的问题：
| 维度 | 得分 | 说明 |
|---|---|---|
| Discovery（被发现） | 2/3 | 触发词清晰，Agent 能找对 |
| Implementation（可执行） | 2/3 | 指令清楚，但偏长 |
| Structure（结构） | 2/3 | 符合 SKILL.md 规范 |
| Expertise（专业度） | 2/3 | 有真领域知识，非泛泛 LLM 输出 |
四个维度齐刷刷 2/3，说明它没明显短板，但也都没到”精通”那一档。两道硬性 flag 才是真正该盯的地方：
-
正文 912 行，超过 500 行上限。这意味着 SKILL.md 把所有示例和子文档都堆进去了，progressive disclosure（渐进式披露）没做好。Agent 每次加载都要吞下 24,602 字符，token 成本高，注意力还容易被稀释。 -
检测到 Windows 风格反斜杠路径。在跨平台场景里，尤其 Windows 用户，这些路径示例可能直接失效。
结构检查本身是通过的：YAML frontmatter 合法、有 name 和 description、有 “Use when” 触发子句、至少一个 H2 标题。所以它”能跑”，只是”不够精”。
谁适合用，谁该绕开
适合：
-
经常让 Agent 处理文档、静态站、模板系统的开发者 -
需要稳定、可复现的 Markdown 转 HTML 输出的流水线 -
不想每次手写转换脚本、又怕 Agent 瞎编正则的人
该绕开：
-
你要的是”带样式的一页式 HTML”。那种该用 jonmagic/markdown-to-standalone-html，它会把图片 base64 内嵌成单文件，离线也能打开 -
你要的是极致排版控制。那直接上 pandoc 加自定义模板更稳 -
你在 Windows 上跑、又依赖它示例里的反斜杠路径。先做好路径修正的心理准备
结论
github/markdown-to-html 是个定位清晰、覆盖面实的工具型 skill。它把”Markdown 转 HTML”这件看似简单、实则坑很多的事，变成 Agent 的一个可靠能力。marked.js 打底，pandoc/Jekyll/Hugo 兜底，三种方言通吃，CLI 和 Node 双工作流。
缺点也明摆着：体量偏胖（912 行）、有 Windows 路径隐患。但对一个 2 万+ 安装量、质量评审过 67 分的刚需 skill 来说，这些是能接受的小毛病。
如果你天天跟 .md 文件打交道，又想让 Agent 帮你稳定转 HTML，这个 skill 值得装。