MinerU 是什麼、怎麼用：把 PDF 和 Office 文檔轉成 Markdown / JSON 的開源解析工具

本文根據 MinerU 官方 GitHub 倉庫 README 整理，資料核對於 2026-10-11。版本迭代快，安裝命令以官方倉庫為準。

是什麼

MinerU 是 opendatalab 組織維護的開源文檔解析工具，README 的介紹是：把 PDF、Office 文檔這類複雜文檔，轉換成可直接供大模型使用的 Markdown / JSON，服務於智能體工作流。做知識庫的人都遇到過這個問題——論文和報告裏有雙欄排版、表格、公式和頁眉頁腳，直接提取文字會一團亂。MinerU 處理的就是這一步。倉庫約有 8.14 萬星標。

能做什麼

README 列出的特性：

• 多種輸入格式：PDF、圖片、DOC/DOCX、PPT/PPTX、XLS/XLSX、EPUB、HTML、CSV 等。
• 輸出 Markdown 或 JSON：保留文檔結構，便於切塊和入庫；表格與公式是它重點處理的內容。
• 四個解析檔位：從最快的 flash 到最精細的 advanced，按速度和質素的需要選擇。
• 多種使用方式：Python SDK、命令行、Gradio WebUI。
• 在線體驗：倉庫連結了 mineru.net 的在線提取工具，以及 Hugging Face、ModelScope、Colab 上的演示。

怎麼上手

README 給出的安裝與使用命令：

bash
pip install uv
uv venv .mineru --python 3.12
source .mineru/bin/activate
uv pip install -U "mineru>=4.0,<5"

mineru-kit parse document.pdf -o document.md --tier standard   # 解析一個文件
mineru-kit webui                                               # 啟動圖形介面

硬件方面，README 說明預設安裝在 CPU 上運行小模型（ONNX），視覺語言模型通過 llama.cpp 以 Vulkan 模式運行；NVIDIA 顯卡用戶可以安裝 mineru[full]>=4.0 獲得更高的處理速度。

不想本地安裝的話，先用在線體驗版試幾份文檔看效果。

免費與付費

項目開源，本地使用免費。許可證是「MinerU Open Source License」，README 說明它基於 Apache 2.0 並附加了條件，商業使用前應閱讀許可全文。在線服務的額度與收費以官網為準。

適合誰 / 不適合誰

適合： 搭建 RAG 知識庫、需要高質素解析論文和報告的開發者；要把大量掃描件、PDF 整理成結構化文本的研究者；希望數據留在本地處理的團隊。

不適合： 只是偶爾把一份 PDF 轉成 Word 的普通用戶（在線轉換工具更省事）；沒有命令行基礎的人（可以只用在線版）；電腦配置很低又要批量處理大量文檔的情況。

注意事項

• 複雜版面、手寫內容和低清掃描件仍可能解析出錯，重要數據（尤其是表格數字）要抽查。
• 高精度檔位明顯更慢，批量任務先用小樣本確定合適的檔位。
• 處理受版權保護或含個人資料的文檔時，遵守相應的使用規定。