前言¶
寫技術文檔時，Markdown 往往是源格式；交付或歸檔時卻要 PDF、Word 或 HTML。反過來，合作方發來的 .docx、.pdf 又需要抽成可編輯的 MD 或純文本。本地裝一整套 Pandoc、Office 宏或在線轉換站點，步驟多、批量時更費時間。若在 Cursor、Claude Code 等支持 Skills 的環境裏，能把「選格式、轉文件、批量跑一遍」交給 Agent，日常文檔流轉會省事不少。
下面介紹 SkillHub 上的 MD格式互轉工具：面向文檔格式互轉的 Skill，在多種格式之間做雙向轉換，並帶安全校驗與質量相關能力。
這是什麼¶
MD格式互轉工具 是 SkillHub 分類 office-efficiency 下的文檔格式互轉 Skill（官方入口：https://api.skillhub.cn/user_98283d0f/md-converter-pro）。定位是文檔格式互轉引擎：在 Markdown、PDF、Word、HTML、純文本 之間雙向轉換，宣稱支持 8 種轉換方向，並內置 安全校驗、質量評分 與 批量處理。
在 SkillHub 上的公開數據（截至撰稿時）：評分 97858，下載 991 次。維護與具體實現細節以 SkillHub 技能頁及安裝後的 SKILL.md 爲準。
核心功能¶
以下能力來自 Skill 公開簡介，安裝後應以技能包內說明爲準。
-
多格式雙向互轉
覆蓋 Markdown、PDF、Word、HTML、純文本；合計 8 種轉換方向（具體路徑以技能文檔列舉爲準）。 -
安全校驗
轉換前或轉換過程中對輸入做校驗，降低異常文件、不可信內容帶來的風險（細則見技能說明）。 -
質量評分
對轉換結果給出質量相關反饋，便於判斷是否要重試或調整源文檔。 -
批量處理
適合目錄內多文件、同一目標格式的一次性轉換，減少重複對話與手工操作。 -
自然語言觸發
可用口語化指令喚起，常見觸發詞包括：MD轉PDF、MD轉Word、MD轉HTML、PDF轉MD、Word轉MD，以及 格式轉換、文檔轉換、批量轉換。
安裝與啓用¶
SkillHub 技能需通過 skillhub CLI 安裝到當前 Agent 的 skills 目錄，否則默認路徑可能不會被識別。安裝流程以 SkillHub 安裝與優先源配置 爲準。
1、檢查或安裝 skillhub CLI¶
先確認本機是否已有 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
2、安裝 MD格式互轉工具¶
官方 API 路徑爲 user_98283d0f/md-converter-pro，與 SkillHub 常見的 @用戶標識/技能名 形式對應，安裝標識爲：
@user_98283d0f/md-converter-pro
將技能裝到當前 Agent 實際使用的 skills 目錄（--dir 必填）。示例：
skillhub search md-converter-pro
skillhub install @user_98283d0f/md-converter-pro --dir <你的 skills 目錄>
也可把下面提示交給 Agent，讓其按官方安裝文檔執行：
請根據 https://skillhub.cn/install/skillhub.md，安裝 `@user_98283d0f/md-converter-pro`。
3、各客戶端 skills 目錄（節選）¶
路徑來自 SkillHub 安裝文檔，裝錯目錄會導致技能不生效：
| 環境 | skills 目錄 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或項目下 .agents/skills/ |
安裝完成後按所用客戶端要求重啓或刷新，使新 Skill 被加載。
典型用法¶
公開資料未附帶逐條 CLI 示例；實際行爲以安裝後的 SKILL.md 與 Agent 執行能力爲準。可按下面方式在對話中復現需求。
-
單文件轉換
說明源文件路徑、當前格式與目標格式，並帶上觸發詞。例如：「用 MD轉PDF，把/path/to/readme.md轉成 PDF，輸出到同目錄。」 -
反向提取
需要可編輯 MD 時，使用 PDF轉MD 或 Word轉MD，並指明文件路徑與是否保留標題層級、圖片等（若技能支持會在執行時說明）。 -
批量轉換
使用 批量轉換 或 文檔轉換，列出目錄路徑、文件後綴過濾條件，以及統一目標格式（如全部 MD轉HTML）。 -
結果確認
若技能返回質量評分或校驗提示，根據說明決定是否調整源文檔後重試。
適用場景與注意¶
適合誰
- 經常在 MD 與 PDF、Word、HTML 之間切換的開發者、技術寫作者或運營。
- 已在 Cursor / Claude Code 等環境使用 Skills，希望把格式轉換收進同一工作流的人。
- 需要一次性處理多個文檔、又不想單獨維護轉換腳本的用戶。
注意
- 官方 API 頁面若無法直接瀏覽，以 SkillHub 搜索「MD格式互轉工具」或上述安裝標識覈對是否仍可安裝；Skill 下架或更名時需改用商店當前條目。
- 複雜版式（多欄、嵌入對象、掃描版 PDF）的還原度取決於技能實現，轉換後宜人工抽查。
- 含敏感內容的文件應在本地或合規環境中處理，並理解技能「安全校驗」覆蓋範圍以技能文檔爲準。
- 批量任務前建議備份源文件，並確認磁盤空間與輸出路徑寫權限。
結尾¶
MD格式互轉工具 把 Markdown、PDF、Word、HTML、純文本之間的互轉和批量處理封裝成 Agent Skill，並強調安全校驗與質量反饋，適合作爲 office-efficiency 類工作流裏的文檔轉換環節。安裝與更新請走 SkillHub 官方流程，技能主頁：
