前言¶
写公众号或运营稿时，正文往往在 Markdown 里起草，但微信编辑器对 HTML 和样式有一套自己的约束：外链样式容易丢、块级结构粘贴后变形，预览和最终排版也对不齐。常见做法是手工调 HTML，或在几个工具之间来回导出，既慢又难和 Agent 工作流衔接。
下面介绍 SkillHub 社区技能「文档转网页」（@user_fd308b11/markdown-html-wechat）。它面向「Markdown → 微信兼容的内联 HTML」这一环，并带上主题样式，便于预览、复制粘贴，或作为下游草稿发布的前置步骤。
这是什么¶
「文档转网页」是 SkillHub 上的 Agent Skill，坐标 @user_fd308b11/markdown-html-wechat，版本 1.0.0，来源为 community，分类 office-efficiency，由发布者 user_fd308b11 维护。标签标明 requires_api_key=false，使用时不需要额外 API Key。
官方简介：
Use when converting Markdown into WeChat-compatible inline HTML with theme styles for preview, copy-paste, or downstream draft publishing.
一句话：在 Agent 需要把 Markdown 转成带主题样式的、微信可用的内联 HTML 时启用该 Skill。
核心功能¶
依据 SkillHub 页面与已抓取元数据，可确认的能力如下：
- Markdown 转 HTML：输出面向微信公众号等场景的内联 HTML（inline HTML），而不是仅供本地浏览器打开的独立网页文件。
- 主题样式：转换结果附带主题样式，便于在编辑器或预览里直接查看效果。
- 三种下游用途：官方说明覆盖预览、复制粘贴到微信编辑器，以及作为下游草稿发布的 HTML 素材。
Skill 本体遵循通用 SKILL.md 格式，由 Agent 在匹配到上述场景时按技能说明执行，而不是单独提供一个与微信无关的静态站点生成器。
安装与启用¶
通过 SkillHub CLI 安装¶
SkillHub 官方安装说明见 skillhub.cn/install/skillhub.md。页面给出的安装提示为：根据该文档安装 @user_fd308b11/markdown-html-wechat。
先确认本机是否已有 CLI：
command -v skillhub && skillhub --version
若未安装，可使用官方脚本（完整安装含 CLI 与默认 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
仅安装 CLI 时：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
安装技能时必须用 --dir 指向当前 Agent 的 skills 目录，否则默认会装到 ./skills/，Agent 可能无法识别。示例：
skillhub install @user_fd308b11/markdown-html-wechat --dir <skills 目录>
各客户端常用 skills 目录（摘自 SkillHub 安装文档）：
| 环境 | skills 目录 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或项目下的 .agents/skills/ |
| Windsurf | ~/.codeium/windsurf/skills/ 或 .windsurf/skills/ |
安装后按你所用 Agent 的惯例重启或刷新技能列表，使新 Skill 生效。
让 AI 代为安装¶
SkillHub 技能页也支持把下面这句发给 Agent，由它按安装文档完成安装：
请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_fd308b11/markdown-html-wechat`。
典型用法¶
公开资料未附带单独的命令行子工具说明，典型用法是在对话中触发转换意图，由 Agent 加载该 Skill 后处理你的 Markdown。
可复现的触发方式包括：
- 先完成上一节的安装，确保技能已在当前 Agent 的 skills 目录中。
- 提供待转换的 Markdown 正文（或文件路径，视 Agent 能力而定）。
- 明确需求，例如：「把这篇 Markdown 转成微信可用的内联 HTML，带上主题样式，方便我预览和粘贴到公众号编辑器。」
Agent 应在 Skill 的 SKILL.md 约束下生成内联 HTML；你可将结果用于预览、复制到微信后台，或交给后续发布流程。具体 HTML 结构、主题名与样式细节以安装后的 Skill 文档为准，本文不展开未在官方页面列出的实现。
适用场景与注意¶
适合谁
- 用 Cursor、Claude Code、Codex 等带 Skills 的 Agent 写稿，目标渠道包含微信公众号或同类富文本编辑器。
- 希望减少「Markdown 写完再手工改 HTML」的重复劳动，并保留可预览、可粘贴的样式。
使用注意
- 输出是微信兼容的内联 HTML，不是通用博客主题或独立部署的静态站；若你的目标是 GitHub Pages 或自有站点，应选用其他工具链。
- 微信编辑器与客户端版本仍可能过滤部分标签或样式，粘贴后建议在实际后台再检查一遍版式。
- 社区来源（community）技能，行为以安装包内
SKILL.md为准；升级可用skillhub在对应--dir下更新，并留意版本号变化。
SkillHub 统计（以抓取数据为准）：评分 100000，下载 8619 次，分类 office-efficiency。
结尾¶
「文档转网页」把 Markdown 到微信内联 HTML 这一步收进 Agent Skill：内联 HTML、主题样式、预览与粘贴场景在官方简介里写得很清楚，且无需 API Key。若你正在 SkillHub 上找办公效率类技能，可按本文安装到对应 Agent 的 skills 目录后试用。
官方页面：https://www.skillhub.cn/skills/user_fd308b11/markdown-html-wechat
API 坐标页：https://api.skillhub.cn/user_fd308b11/markdown-html-wechat
