前言¶

在 Agent 裏處理簡歷、JD、作品集或彙報材料時，模型往往只能看到文件名或你手動粘貼的片段。若希望先做總結、改寫、問答或結構化提取，通常需要先把 PDF、Word、PPT 等轉成可編輯的 Markdown。自己搭解析鏈路要對接上傳、輪詢和結果落盤；「文檔轉md」這一 Skill 把 MinerU 的解析能力封裝進通用 SKILL.md 工作流，由 Agent 按說明調用 bundled script，完成本地文件或遠程 URL 的轉換並保存 Markdown。

這是什麼¶

「文檔轉md」是 SkillHub 上的社區 Skill（座標 @user_ec02b303/xtyooo-mineru-doc-to-markdown-skill，版本 1.0.0，分類 office-efficiency，發佈者 user_ec02b303）。它使用 MinerU 將 pdf、doc、docx、ppt、pptx、圖片或 html 轉爲 Markdown，適合「先轉 md，再進入後續工作流」的場景。

與在對話裏零散粘貼正文不同，該 Skill 強調通過腳本完成上傳、遠程解析、輪詢和保存，便於把同一份文檔穩定地交給後續步驟。

核心功能¶

下面介紹已見於官方簡介與 SkillHub 頁面的能力，不展開未公開的腳本參數。

1. 格式覆蓋：支持 pdf、doc、docx、ppt、pptx、圖片、html 轉 Markdown。
2. 兩種 API 路徑：優先讀取環境變量 MINERU_API_TOKEN，調用精準解析 API；未配置 token 時，自動降級到免 token 的 Agent API。
3. 輸入方式：bundled script 支持本地文件上傳與遠程 URL 解析，並在任務完成後保存 Markdown 輸出。
4. 典型上游場景：官方說明中列舉簡歷、JD、作品集等文檔，轉 md 後可用於總結、改寫、問答、結構化提取或接入其他工作流。
5. 標籤說明：Skill 帶有 requires_api_key=true；是否配置 MINERU_API_TOKEN 會影響走精準 API 還是降級路徑，而非一律不可用。

安裝與啓用¶

SkillHub 頁面給出的安裝方式是：讓 AI 按 SkillHub 安裝文檔 安裝本 Skill。座標如下。

@user_ec02b303/xtyooo-mineru-doc-to-markdown-skill

若本機已安裝 skillhub CLI，可按安裝文檔第三節，用 --dir 指向當前 Agent 的 skills 目錄（裝到默認 ./skills/ 可能不會被識別）。示例命令形態如下，請將 <skills 目錄> 換成你環境對應的路徑。

command -v skillhub && skillhub --version

skillhub install @user_ec02b303/xtyooo-mineru-doc-to-markdown-skill --dir <skills 目錄>

安裝文檔中列出的常用 skills 目錄包括：

• Cursor：~/.cursor/skills/
• Claude Code：~/.claude/skills/
• Codex：~/.codex/skills/ 或項目下的 .agents/skills/

CLI 尚未安裝時，可按文檔使用官方安裝腳本（完整安裝或 --cli-only），具體命令見 https://skillhub.cn/install/skillhub.md 第一節。

啓用精準解析前，在運行 Agent 或執行腳本的環境中配置：

export MINERU_API_TOKEN="<你的 MinerU API Token>"

未設置時，Skill 說明會走免 token 的 Agent API 降級路徑。

典型用法¶

官方未在公開頁面給出單獨的 shell 示例；可復現的使用方式是與 Agent 協作，由 Skill 指導調用 bundled script。可按下面順序操作。

1. 完成 Skill 安裝，並視需要設置 MINERU_API_TOKEN。
2. 在對話中說明需求，例如：將某份 PDF 簡歷或某 JD 的 docx 轉爲 Markdown，並指定本地路徑或文檔 URL。
3. Agent 按 Skill 說明執行：上傳本地文件或提交遠程 URL、輪詢 MinerU 解析任務、將結果保存爲 Markdown 文件或返回內容。
4. 在得到的 Markdown 上繼續讓 Agent 做總結、改寫、問答或字段抽取。

若你使用 Cursor，安裝目錄應爲 ~/.cursor/skills/；安裝或更新 Skill 後，若 Agent 未加載新技能，可按你所用客戶端的慣例重啓或刷新技能列表。

適用場景與注意¶

適合誰：需要在 Agent 內處理多格式辦公文檔、且希望統一走 MinerU 解析鏈路的開發者或效率向用戶；分類爲 office-efficiency，與文檔預處理場景一致。

使用注意：

• 精準解析依賴 MINERU_API_TOKEN；無 token 時使用降級 API，解析質量或配額以 MinerU 與 Skill 實際行爲爲準，安裝前可在對話中確認當前走哪條路徑。
• Skill 爲社區來源（community），維護與 MinerU 服務變更需自行關注 SkillHub 上的版本更新（當前頁面標註 v1.0.0）。
• 涉及簡歷、JD 等敏感文件時，上傳與 URL 解析會經過 MinerU 相關服務，請按組織合規要求評估。

SkillHub 頁面展示的統計（以頁面與抓取資料爲準）：評分 100000，下載 2132，安裝 21。具體數字以你訪問 SkillHub 時爲準。

結尾¶

「文檔轉md」把 MinerU 的多格式解析和 Markdown 落盤收斂成一個可安裝的 Agent Skill，用環境變量切換精準 API 與免 token 降級，適合把文檔先變成 md 再接入後續自動化。官方入口：

• SkillHub：https://www.skillhub.cn/skills/user_ec02b303/xtyooo-mineru-doc-to-markdown-skill
• API 座標頁：https://api.skillhub.cn/user_ec02b303/xtyooo-mineru-doc-to-markdown-skill