前言¶
教材講義、論文附錄、作業掃描件常以 PDF 形式流轉。裏面若有大量數學公式和表格，直接複製到 Word 往往亂版，公式變成圖片或亂碼，後續批改、摘錄、二次排版成本很高。常見做法是手工重打公式，或藉助通用 PDF 轉 Word 工具，但對掃描版、公式密集文檔，效果經常不穩定。
下面介紹 SkillHub 上的「數學公式pdf轉可編輯word格式」Skill。它面向掃描版數學 PDF，目標是把內容整理成排版相對整潔的 Word，並儘量保留公式（OMML）和表格結構，轉換鏈路依賴 MinerU、Pandoc 與 python-docx。本文事實來自任務提供的 Skill 簡介與 SkillHub 公開指標；撰寫時 https://api.skillhub.cn/user_1627842f/pdf-toord 無法通過 GET 拉取詳情（HTTP 405），具體安裝話術請以 SkillHub 官方地址爲準。
這是什麼¶
「數學公式pdf轉可編輯word格式」是發佈在 SkillHub 的 Agent Skill，官方入口爲：
https://api.skillhub.cn/user_1627842f/pdf-toord
在 SkillHub 分類爲 office-efficiency，社區評分爲 97783，下載量 862 次（數據隨 SkillHub 更新而變化）。
一句話定位：讓支持 Skills 的編碼 Agent 按 SKILL.md 中的流程，把掃描版數學 PDF 轉成可編輯的 .docx，而不是隻產出純圖片頁或丟失公式結構的粗糙文檔。
核心功能¶
結合 Skill 簡介，目前可確認的能力如下。
- 輸入：掃描版數學 PDF（含公式、表格的版面）。
- 輸出：Word 文檔（
.docx），強調整體排版可讀、便於後續編輯。 - 公式：以 Word 原生 OMML（Office Math Markup Language）形式保留，便於在 Word 內繼續改公式，而不是整頁貼圖。
- 表格：儘量保留表格結構，避免轉完後表格塌成純文本流。
- 技術棧：Skill 說明中明確依賴 MinerU（文檔解析與版面/公式識別）、Pandoc（格式轉換鏈路中的一環）、python-docx（對 Word 文檔進行生成或後處理）。
Skill 本身不替代這三個組件的安裝與授權配置；它主要是把「解析 → 轉換 → 生成 docx」的步驟寫進 Agent 可執行的說明裏，減少你每次口述流程的負擔。
安裝與啓用¶
這類 Skill 通常遵循通用 SKILL.md 格式：倉庫或壓縮包內有一份說明，Agent 讀取後按步驟調用本機或已配置環境中的工具。
由於官方 API 地址當前無法直接抓取安裝命令，建議按下面順序操作，避免與頁面不一致：
- 在瀏覽器打開 SkillHub 上的技能頁（與官方地址同一技能 ID 的展示頁，例如
https://skillhub.cn/skills/user_1627842f/pdf-toord），查看是否提供「複製給 Agent 的安裝話術」或 CLI 安裝說明。 - 將頁面給出的安裝話術發給 Cursor、Codex CLI、Claude Code 等已啓用 Skills 的 Agent，由 Agent 完成 Skill 落盤與目錄配置。
- 在本機或 Agent 運行環境中提前準備 Skill 簡介列出的依賴，至少包括：
- MinerU：用於 PDF 解析、掃描件 OCR、公式識別等（參見 OpenDataLab MinerU 官方文檔安裝 CLI 或 API）。
- Pandoc：用於文檔格式轉換，需保證pandoc在 PATH 中可用。
- python-docx：Python 包，用於讀寫.docx；一般通過pip install python-docx安裝（具體版本以 SKILL.md 或 Agent 執行日誌爲準）。
不同 Agent 對 Skills 的目錄名、環境變量名可能略有差異；以 SkillHub 頁面與解壓後的 SKILL.md 爲準，本文不列舉未經頁面覈實的配置項。
典型用法¶
官方詳情頁本次未能抓取到逐步示例，下面是根據 Skill 簡介整理的預期工作方式，實際命令與參數以安裝後的 SKILL.md 爲準。
- 準備輸入：將待轉換的掃描版數學 PDF 放在 Agent 可訪問的路徑，或按 SKILL.md 要求上傳/指定文件。
- 觸發 Skill：在對話中說明需求，例如需要將某 PDF 轉爲可編輯 Word、且需保留公式與表格；並引用已安裝的「數學公式pdf轉可編輯word格式」Skill（名稱以 SkillHub 展示爲準）。
- 解析階段（MinerU）：Agent 按 Skill 調用 MinerU，對 PDF 做版面分析；掃描件會走 OCR，公式通常會被識別爲可再加工的表示（如 LaTeX 等中間形態，具體以 MinerU 輸出爲準）。
- 轉換與生成（Pandoc + python-docx）：在中間結果基礎上生成
.docx，並把公式寫入 OMML、表格寫入 Word 表格結構；必要時用 python-docx 微調段落或樣式。 - 驗收：在 Microsoft Word 或兼容 OMML 的套件中打開輸出文件，檢查公式是否可編輯、表格是否對齊、分頁是否合理；有問題時把樣例頁反饋給 Agent，按 SKILL.md 中的排錯建議迭代。
若你已有 MinerU 使用經驗，可把本 Skill 理解爲把「數學掃描 PDF → 結構化中間稿 → 帶 OMML 的 docx」固化成 Agent 可重複執行的劇本，而不是每次從零寫腳本。
適用場景與注意¶
更適合
- 需要從掃描 PDF 得到可改動的 Word 講義、習題、附錄。
- 文檔以數學公式和表格爲主，希望在 Word 裏繼續改公式而不是修圖。
- 願意在本地或指定環境安裝 MinerU、Pandoc、Python 生態，並接受多步轉換的耗時。
限制與注意
- 依賴環境：三者任一未安裝或版本不匹配，轉換可能失敗或降級爲純文本/圖片；安裝前先看 SKILL.md 與 MinerU 官方要求（GPU/CPU、OCR 語言等）。
- 掃描質量：模糊、傾斜、手寫過多的頁面會影響 OCR 與公式識別，輸出仍需人工校對。
- 公式複雜度：極複雜公式、特殊符號、混排圖公式，OMML 還原程度取決於 MinerU 識別與後續轉換規則，不能等同於「與原 PDF 像素級一致」。
- 官方信息獲取：若 SkillHub 頁面顯示技能下線或 API 不可用，需聯繫發佈者或改用 SkillHub 上同類的 office-efficiency 技能；下載量與評分僅作選型參考，不代表單次轉換質量。
結尾¶
「數學公式pdf轉可編輯word格式」把掃描版數學 PDF 轉 Word、保留 OMML 公式與表格結構這件事，收斂成 Agent 可執行的 Skill，並明確依賴 MinerU、Pandoc 與 python-docx。若你經常處理這類文檔，值得在 SkillHub 查看說明並安裝到常用 Agent 裏試跑一份樣例 PDF。
官方地址：https://api.skillhub.cn/user_1627842f/pdf-toord
