前言¶
写技术文档时，Markdown 往往是最顺手的一层；要给别人看、要挂内网或临时分享，却还要自己套 HTML 模板、处理代码块样式。用 Pandoc 或手写脚本能转，但样式和高亮要自己配一遍。若你已经在 Cursor、Claude Code 等环境里用 Agent 写稿，更希望说一句「把这份 md 变成能打开的网页」，由 Skill 按约定产出带样式的 HTML。
下面介绍 SkillHub 社区 Skill Markdown转HTML（坐标 @user_bbc7674c/markdown-2-html），它面向「Markdown 源文件 → 可展示的 HTML 页面」，并强调代码语法高亮。
这是什么¶
Markdown转HTML 是发布者 user_bbc7674c 在 SkillHub 上架的社区 Skill，当前版本 1.0.0，分类为 office-efficiency。官方说明：将 Markdown 文件转换为带样式的 HTML 网页，并对代码块做语法高亮；适用于把 .md 转成 HTML、从 Markdown 文档生成网页、或需要「有样式 + 代码高亮」的 HTML 输出。
Skill 标签标明 requires_api_key=false，不依赖额外 API Key。在 SkillHub 页面可见评分 100000、下载 1104、安装 6（数据以 SkillHub 展示为准）。
核心功能¶
依据官方简介，可核实的能力包括：
- Markdown → HTML：把 Markdown（
.md）内容转换为 HTML 格式。 - 网页化输出：生成可用于网页展示的 HTML 页面，而非裸文本片段。
- 代码语法高亮：输出侧包含对 Markdown 中代码块的语法高亮处理。
- 意图触发：当用户表达「convert markdown to html」「md to html」「markdown转网页」「生成html页面」「代码高亮」等需求，或手头 Markdown 需要 Web 呈现时，Agent 应选用本 Skill。
具体转换规则、默认主题与文件落盘方式以 Skill 包内 SKILL.md 为准；安装后可在技能目录中查看。
安装与启用¶
SkillHub 官方页面给出的方式是：让 AI 按安装文档安装指定坐标。
方式一：自然语言交给 Agent
将下面提示发给当前 AI（与 SkillHub 页面一致）：
请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_bbc7674c/markdown-2-html`。
方式二：使用 SkillHub CLI
先确认是否已安装 CLI（文档见 https://skillhub.cn/install/skillhub.md）：
command -v skillhub && skillhub --version
未安装时可执行完整安装（含 CLI 与默认 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
安装本 Skill 时，必须用 --dir 指向当前 Agent 的 skills 目录，否则默认装到 ./skills/ 可能不会被识别：
skillhub install @user_bbc7674c/markdown-2-html --dir <skills 目录>
常见客户端 skills 路径（摘自 SkillHub 安装文档）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
装好后按你所用客户端的要求重启或刷新 Agent，使技能被加载。
典型用法¶
本 Skill 没有单独公开的逐步教程页；用法与官方简介中的触发场景一致。经过上面的安装步骤后，可在对话中直接说明目标，例如：
- 指定一个本地或工作区内的
.md文件，要求「转成 HTML 页面」。 - 粘贴 Markdown 正文，要求「生成带代码高亮的 HTML，方便浏览器打开」。
- 使用关键词「markdown转网页」「md to html」等，让 Agent 自动选用本 Skill。
Agent 会按 Skill 内指令完成转换与样式处理；你只需确认输出 HTML 的路径或内容是否符合预期，再在浏览器中打开验证代码块高亮与排版。
适用场景与注意¶
适合谁
- 经常把 README、技术笔记、博客草稿从 Markdown 导出为可分享网页的开发者。
- 已在 Cursor / Claude Code 等环境使用 Skills，希望减少手写 HTML 模板和重复配置高亮库的情况。
注意
- 来源为 community，行为以安装包中的 Skill 定义为准；升级前可在 SkillHub 查看版本 1.0.0 是否有更新。
- CLI 安装技能务必指定正确的
--dir，并与客户端文档中的 skills 目录一致。 - 若仅需纯 HTML 片段、无样式要求，或需要 PDF 等非 HTML 格式，应选用其他工具或 Skill，避免误用本技能的网页化输出假设。
结尾¶
Markdown转HTML 把「Markdown 写稿」和「带语法高亮的 HTML 展示」串成一条 Agent 可执行的链路，适合在写文档的同时快速生成可打开的网页。安装与详情见 SkillHub：
- 技能页：https://www.skillhub.cn/skills/user_bbc7674c/markdown-2-html
- 安装说明：https://skillhub.cn/install/skillhub.md
- API 坐标页：https://api.skillhub.cn/user_bbc7674c/markdown-2-html
