1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | markdown-to-html-github-awesome-copilot |
| 作者/维护者 | GitHub awesome-copilot 合集,子技能由社区贡献者 jhauga 于 2026-01-29 提交 |
| 来源链接 | https://github.com/github/awesome-copilot/tree/main/skills/markdown-to-html |
| 许可证 | MIT(数据来自 GitHub API) |
| GitHub Stars / Forks | 所属合集仓库整体 39,667 / 5,045(GitHub API);该数字属整个合集,不代表本技能自身热度 |
| 第三方装机量 | skills.sh 显示约 10.0K 次安装(网页抓取) |
| 最新变更 | 2026-01-29(子目录最近一次提交) |
| 安装方式 | npx skills add https://github.com/github/awesome-copilot --skill markdown-to-html,或复制子目录到 skills 目录 |
2. 功能介绍与亮点
一份“Markdown 转 HTML”的操作手册型技能:SKILL.md 约 24KB,另带 15 个 references 文件,教 agent 用合适的工具完成转换,或自己写转换脚本。
- 覆盖四类工具:marked.js(Node/CLI)、pandoc(跨格式)、gomarkdown(Go)、Jekyll/Hugo(静态站点模板)
- 逐项给出 Markdown → HTML 的对照示例:基础语法、代码块、折叠段落、表格、数学公式
- 说明 CommonMark、GFM 等不同 Markdown 风格的支持程度
- 明确警告 marked 不会清洗输出 HTML,处理不可信输入要配合 DOMPurify 等清洗库
- 纯文档型技能:无附带脚本,转换由 agent 调用你已装好的工具完成
3. 适用场景
所属分类:文档与办公自动化。
- 把 README、笔记、周报等 .md 文件批量转成可发布的 HTML
- 搭建或调试 Jekyll、Hugo 等以 Markdown 为内容源的静态站点
- 需要让 agent 自写一段 Markdown 转 HTML 的脚本,并希望覆盖表格、公式、代码块等边角情况
- 初中级用户:不熟悉 marked / pandoc 命令行参数,也能让 agent 选对工具
4. 跨 Agent 兼容性
| Agent | 结论 | 依据 |
|---|---|---|
| Claude Code | 原生支持 | 标准 SKILL.md(name/description)加 references 目录,放入 skills 目录即可 |
| Codex | 需适配 | 同为 SKILL.md 格式,但 Codex 不自动发现该目录,需手动引用 |
| OpenClaw | 未验证 | 格式兼容,未实测 |
| Hermes Agent | 未验证 | 格式兼容,未实测 |
5. 推荐理由
- 转换类需求高频,但参数、风格差异、边角语法容易出错;这份手册把常见坑集中写清
- 一份技能覆盖 marked、pandoc、Go、Jekyll、Hugo 五条路线,换工具不用换技能
- 内置对不可信输入的清洗提醒,避免把未清洗的 HTML 直接发布
- 第三方装机量约 10K,是通用型 Markdown 转 HTML 技能中采用度较高的一个
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | skills.sh 装机量约 10.0K,为独立第三方采用数据;所属合集 39.7k stars |
| 可用性 | 7 | 文档详尽、示例完整、无需配置;但最近一次变更在 2026-01,超过 6 个月;转换工具需自行安装 |
| 安全性 | 9 | 纯文档,无脚本、无联网、无凭据;MIT;skills.sh 上 Gen Agent Trust Hub、Socket、Snyk 三项审计均为 PASS |
综合 7.67。
安全检查清单:
- Shell 权限:技能本身不声明权限;文中建议的命令是
npm install marked、pandoc,范围明确 - 联网外发:技能本身无;npm 安装依赖会联网下载
- 凭据:不需要
- 可疑指令:通读 SKILL.md,未发现
- 作者/组织信誉:GitHub 官方合集收录,贡献者为社区开发者(账号 2015 年注册)
- License:MIT
- 维护:合集仓库 2026-10-01 仍有推送;本子目录最近变更 2026-01-29
7. 跟同类 Skills 相比的优势
| 项目 | 定位 | 与本技能的差异 |
|---|---|---|
| baoyu-markdown-to-html(jimliu/baoyu-skills) | 转成带微信公众号主题的内联样式 HTML,支持 Mermaid、数学公式 | 带脚本、依赖 bun 与无头 Chrome,面向公众号排版;本技能是通用工具选型手册 |
| markdown-html-orchestrator(alirezarezvani/claude-skills) | 文档生成编排 | 偏文档流水线,不讲各转换工具的用法 |
| 直接使用 marked / pandoc 命令行 | 工具本身 | 无需技能;本技能补的是 agent 选工具、避开边角坑的知识 |
核心差异:不绑定某一个转换器,覆盖五条技术路线且带清洗警告,是纯文档、零脚本的通用手册。
8. 用户评价
该技能目前在第三方平台尚无具名用户评价。skills.sh 页面显示的是 10.0K 装机量与三项自动化安全审计 PASS(工具审计,非用户评价)。
9. 其他补充
references 目录含 marked、pandoc、gomarkdown、hugo、jekyll 的独立说明,以及表格、代码块、折叠段落、数学公式各一对“语法—转换”文档,可单独查阅。
10. 安装使用方式
npx skills add https://github.com/github/awesome-copilot --skill markdown-to-html
# 或手动复制
git clone --depth 1 https://github.com/github/awesome-copilot.git
cp -r awesome-copilot/skills/markdown-to-html ~/.claude/skills/
安装后说“把 README.md 转成 HTML”即可触发;新技能一般需重开会话。要用 marked 需先装 Node.js 并执行 npm install -g marked,要用 pandoc 需另行安装。
11. 注意事项
- 技能只提供知识,实际转换依赖你本机装好的 marked、pandoc 等工具
- marked 不清洗输出,处理不可信 Markdown 必须再过一层清洗库
- 文中的数学公式示例输出是示意写法,不同转换器的实际输出标签可能不同,以所用工具为准
- 最近一次变更为 2026-01,Markdown 规范本身稳定,影响有限