前言¶
寫公衆號或運營稿時，正文往往在 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
