写完 Markdown 还要手动转 HTML？这个 GitHub 官方 Skill 帮你一键搞定

每次写完 Markdown 文档，最烦的就是手动转 HTML？表格要对齐、代码块要语法高亮、公式要渲染——自己写脚本容易出 bug，用在线工具又有隐私风险。

GitHub 官方推出的 markdown-to-html Skill，就是来解决这个痛点的。它不是一个工具，而是覆盖了市面上最主流的 4 种转换方案：marked.js（Node.js/CLI）、pandoc（全能格式转换）、gomarkdown（Go 项目专用）、Jekyll/Hugo（静态博客用户最熟）。装上这个 Skill，AI 助手就知道什么时候该用哪个工具、怎么配参数、出了错怎么调。

为什么值得装？

市面上转 Markdown 的工具一抓一大把，但坑也一堆：特殊字符乱码、表格不渲染、代码块丢格式。markdown-to-html 这个 Skill 的价值在于它把「哪些工具能做什么、不能做什么、出了问题怎么排查」全部整理好了，相当于一份实战型避坑手册。

它支持的 Markdown 方言也很全：

• CommonMark 0.31 — 98% 覆盖
• GitHub Flavored Markdown（GFM） — 表格、删除线、Fenced Code 全面支持
• 数学公式 — LaTeX 语法转 MathML，学术文档党狂喜
• 折叠区块 — `
  
  ` 那种，对 FAQ 类文档特别友好

实际场景举例

假设你让 AI 帮你写一份 API 文档，结尾要求生成 HTML 方便团队分享。传统方式 AI 可能直接输出带 `##` 标题的原始 Markdown——但有了这个 Skill，AI 会先判断你的技术栈：如果你用的是 Next.js + Node.js，它会用 marked.js 配 highlight.js；如果你说「我要转 Word」，它知道切 pandoc。

还有一个细节很实用：Skill 专门列出了每种工具的「安全警告」。比如 marked.js 输出不做 XSS 过滤，Skill 会提醒你接 DOMPurify；pandoc 对不可信输入建议加 `–sandbox` 参数。这些小细节在真实写稿场景里特别管用。

怎么安装

在支持 Skills 的 AI 助手（如 Claude Code、Cursor、Windsurf）里，执行：

npx skills add https://github.com/github/awesome-copilot --skill markdown-to-html

也可以去 Smithery.ai 直接搜索「github/markdown-to-html」安装，支持 20+ 主流 AI 编程工具。

适合谁用？

需要频繁把 Markdown 转成 HTML 或其他格式的开发者、技术文档作者、静态博客主（尤其是用 Jekyll 或 Hugo 的），以及任何在 AI 编程工具里经常处理文档格式问题的用户。GitHub 官方背书 + 27.4K Repo Stars，品质有保证。

👉 GitHub：github/awesome-copilot/skills/markdown-to-html

GitHub: https://github.com/github/awesome-copilot/tree/main/skills/markdown-to-html