前言¶
處理用戶上傳的附件時，PDF、Word、Excel、PPT 這些格式沒法直接進對話，得先本地裝一堆轉換庫、寫臨時腳本，做完還要清理環境。這類需求重複出現，每次都重新造輪子成本不低。下面介紹的 Skill 用微軟開源的 MarkItDown 把這件事收斂成一個固定動作：把文件交給它，拿回 Markdown 文本。
這是什麼¶
「萬能文件轉 Markdown」是一個基於通用 SKILL.md 格式的社區 Skill，座標 @user_825f001d/markitdown，分類 office-efficiency，發佈者 user_825f001d，來源 community，當前版本 1.0.0。
它的底層是微軟開源的 MarkItDown 0.1.8。解決的問題是：把 PDF、Word、Excel、PPT、HTML 等常見文檔格式統一轉成 Markdown，讓對話模型能直接讀取附件內容，不需要用戶自己準備轉換環境。
SkillHub 頁面上的評分爲 100000，下載量 1384 次（截至抓取時）。標籤顯示 requires_api_key=false，即不需要額外配置 API Key。
核心功能¶
支持的輸入格式來自頁面簡介，逐條列出：
- Word（docx）
- Excel（xlsx）
- PPT（pptx）
- HTML
- CSV
- JSON
- XML
- EPUB
- RSS
- ZIP
- 圖片（提取 EXIF 信息）
批量轉換，即可以一次處理多個文件，而不是單個文件手工跑一遍命令。轉換結果統一爲 Markdown 文本，可直接讀入對話上下文。
觸發場景按頁面描述：用戶要求「把 PDF/Word/Excel/PPT 轉成 markdown」「提取這份文檔的內容」「docx 轉 md」「網頁轉 markdown」，或需要把 Office 附件內容讀入對話時使用。
安裝與啓用¶
該 Skill 已預裝在託管 venv 中，本機不需要再執行 pip install。啓用方式就是把它安裝到你的 Agent 環境：
SkillHub 頁面：https://www.skillhub.cn/skills/user_825f001d/markitdown
官方地址：https://api.skillhub.cn/user_825f001d/markitdown
在 Cursor、Codex CLI、Claude Code 中的具體安裝入口，抓取資料裏沒有區分說明，這裏不補充未經覈實的步驟。從 SKILL.md 的通用格式來看，把 Skill 目錄放進對應的 skills 目錄即可被識別，具體路徑以各工具的文檔爲準。
典型用法¶
由於本機已裝在託管 venv，實際調用方式就是讓 Agent 在用戶提出轉換需求時自動觸發，例如：
用戶：「把這份 docx 轉成 markdown，我要看看裏面的內容。」
Agent 識別到附件是 Office 文檔，走這個 Skill 把 docx 轉成 Markdown 後返回文本。同樣的流程適用於 PDF、xlsx、pptx、網頁和 CSV。
命令行層面的對應操作由底層 MarkItDown 提供，例如對單個文件做轉換。這裏只描述到 Skill 這一層：觸發條件明確（用戶提出文檔轉換或內容提取訴求），輸入是常見文檔格式，輸出是 Markdown 文本。
適用場景與注意¶
適合的場景：
- 需要把用戶上傳的 Office 附件內容讀進對話，但不想在本地維護各類文檔解析依賴。
- 批量處理一批 PDF、docx、xlsx、pptx 文件，統一拿到 Markdown 文本再做後續處理。
- 網頁、CSV、JSON、XML 等結構化或半結構化內容要轉成可讀文本。
需要注意的地方：
- ZIP 是解包取內容，圖片只提取 EXIF 信息，這兩類不是把二進制本身轉成可讀正文。
- 轉換質量取決於源文檔的格式規範程度，複雜排版、掃描版 PDF 的效果以實際運行爲準，資料裏沒有給出質量承諾。
- 當前版本 1.0.0，社區來源，更新節奏看發佈者。
- 不需要 API Key，但 MarkItDown 依賴託管 venv 裏的 Python 環境，環境不可用時轉換會失敗。
結尾¶
這個 Skill 的價值在於把「文檔轉 Markdown」從一次性腳本變成環境裏常備的能力：格式覆蓋面廣，批量處理，不需要 API Key，本機已裝好。需要把 Office 附件內容讀入對話時，先走它轉成 Markdown，再進入後續處理。
官方地址：https://api.skillhub.cn/user_825f001d/markitdown
SkillHub 頁面：https://www.skillhub.cn/skills/user_825f001d/markitdown
