跳转到主要内容
PromptQuorum为人类设计。 为AI结构化。
主页/本地LLM进阶
RAG & Document Chat

MinerU 评测:支持 Markdown、LaTeX 和 RAG 的源码公开文档解析器

·6 分钟阅读 作者 · PromptQuorum创始人 · 开放权重与开源AI发现引擎

MinerU(GitHub 83,000+ 星)将 PDF、DOCX、PPTX、XLSX、HTML、EPUB 和图片转换为 Markdown、HTML、LaTeX、DOCX 和 EPUB;默认在本地运行,在 MinerU Open Source License(Apache 2.0 加附加条款)范围内免费,支持 GPU 加速和跨页表格合并。 安装命令:pip install mineru(Python 3.11–3.14)。

关键要点

  • MinerU Open Source License(Apache 2.0 加附加条款);GitHub 83,000+ 星;OpenDataLab 维护。
  • pip install mineru:需要 Python 3.11–3.14。
  • 输出:Markdown、HTML、LaTeX、DOCX 和 EPUB。
  • 跨页表格合并;块级边界框。
  • GPU 自动检测;README 称在代表性推理工作负载上约比 CPU 快 2–3 倍。

📍 简单一句话

MinerU 是由 OpenDataLab 维护的 Python 库,采用 MinerU Open Source License(Apache 2.0 加附加条款),将 PDF、DOCX、PPTX、XLSX、HTML、EPUB 和图片转换为 Markdown、HTML、LaTeX、DOCX 和 EPUB,支持 GPU 加速和跨页表格合并。

💬 简单来说

输入文档,MinerU 读取结构、文字和表格(包括跨页表格),输出 Markdown 或 LaTeX 供 RAG 系统或 LLM 直接使用。默认情况下解析在本机进行,文档不会被上传。

📌注: PromptQuorum 未对 MinerU 进行实机测试。所有信息来自 github.com/opendatalab/MinerU 和 opendatalab.com(2026 年 11 月 15 日查阅)。

MinerU 是由 OpenDataLab 维护、源码公开的 Python 库,采用 MinerU Open Source License(在 Apache 2.0 基础上增加附加条款),可将 PDF、DOCX、PPTX、XLSX、HTML、EPUB 和图片转换为 Markdown、HTML、LaTeX、DOCX 和 EPUB,支持跨页表格合并、边界框和 GPU 加速。本评测基于 MinerU GitHub 仓库 和 opendatalab.com(2026 年 11 月 15 日查阅)。

MinerU 评测:支持 Markdown、LaTeX 和 RAG 的源码公开文档解析器

功能

  • 输入格式: PDF、DOCX、PPTX、XLSX、HTML、EPUB 及常见图片格式。
  • 输出格式: Markdown(默认)、HTML、LaTeX、DOCX 和 EPUB(为 README 所列导出目标中的一部分;README 称各 CLI/API 仅提供其中一个子集)。
  • OCR: 模型驱动的 OCR,处理扫描文档。
  • 跨页表格合并: 跨多页的表格被检测并合并为单个表格。
  • 边界框: 块级坐标,可用于精确引用。
  • GPU 自动检测: NVIDIA/AMD/Intel/Apple Silicon,README 称在代表性推理工作负载上约快 2–3 倍。
  • 默认本地: 默认不上传文档,远程解析需要显式配置。

安装

数据流向

  • 默认情况下解析在本机进行,文档不会被上传;远程解析需要显式配置。本地解析的设置可能需要下载模型(README 列出的大小因档位而异,约 0.8–3 GB),因此首次设置需要网络连接。
  • 远程/云模式需要显式配置,并非默认。
  • README 称 Doclib 组件包含使用情况和诊断遥测(初始启用,不含文档内容、提取的文本、文件名和搜索查询);可通过 mineru telemetry disable 或在 Doclib 服务器环境中设置 MINERU_TELEMETRY_DISABLED=1 关闭。
  • OpenDataLab 的 GitHub 组织页面将所在地列为中国(GitHub 个人资料)。托管服务 mineru.net 在页脚链接了隐私政策和用户协议;向任何远程模式发送机密文档前请先阅读。本地解析不会上传文档。

许可证与价格

  • 许可证: MinerU Open Source License,基于 Apache 2.0 并附加条款(不是标准的 Apache-2.0)。除非您及关联方的月活跃用户超过 1 亿,或月总收入超过 2000 万美元,否则无需单独许可即可商用;基于 MinerU 构建的在线服务必须明确标明使用了 MinerU;违反条款时许可自动终止。商用前请阅读 LICENSE.md。
  • 价格: 该库可免费下载并在本地运行;托管服务 mineru.net 及其远程 API 的定价和使用限制未作评估。
  • 上述阈值来自 LICENSE.md,其中未提及模型权重。安装时下载的模型可能适用各自的许可证;商用部署前请逐一核实。

竞品与替代方案

  • Docling — MIT 许可;由 IBM Research Zurich 发起,由 LF AI & Data Foundation 托管;MCP 通过独立软件包 docling-mcp 提供。
  • Marker — 代码采用 Apache 2.0,模型权重采用带商用限制的修改版 AI Pubs Open RAIL-M 许可(商用前请核实);Surya OCR;Markdown 和含边界框的 JSON。
  • Unstructured — Python ETL;支持邮件等广泛格式。
  • OpenDataLoader PDF — 仅 PDF 的解析器,提供 Python、Node.js 和 Java SDK;输出含边界框的 JSON、Markdown 和 HTML。

在目录中比较

常见问题

MinerU 可以免费商用吗?

基本可以。MinerU 采用 MinerU Open Source License(Apache 2.0 加附加条款)。除非您及关联方的月活跃用户超过 1 亿,或月总收入超过 2000 万美元,否则无需单独许可即可商用;基于 MinerU 构建的在线服务必须明确标明使用了 MinerU。请阅读 GitHub 上的 LICENSE.md。

MinerU 与 Docling、Marker 的区别是什么?

MinerU 的 README 记载了 LaTeX 输出和跨页表格合并;选择前请查阅 Docling 和 Marker 的文档,确认是否具备相同功能。Docling 通过独立软件包 docling-mcp 提供 MCP 支持;Marker 使用 Surya OCR。

MinerU 需要 GPU 吗?

不需要。MinerU 可在 CPU 上运行。GPU 会被自动检测;README 称在代表性推理工作负载上约为 CPU 速度的 2–3 倍,实际速度取决于您的硬件和文档类型。

如何安装 MinerU?

在 Python 3.11–3.14 环境中运行 pip install mineru,推荐使用虚拟环境。

MinerU 支持扫描 PDF 吗?

支持。MinerU 包含模型驱动的 OCR,可处理扫描文档和图片 PDF。

MinerU 支持哪些输出格式?

Markdown(默认)、HTML、LaTeX、DOCX 和 EPUB(为 README 所列导出目标中的一部分;README 称各 CLI/API 仅提供其中一个子集)。

MinerU 有 MCP 服务器吗?

README 未描述 v4.2.2 的 MCP 服务器。需要 MCP 集成时请考虑 Docling(独立软件包 docling-mcp)。

谁维护 MinerU?

OpenDataLab 维护 GitHub 仓库。

MinerU 能合并跨页表格吗?

能。跨多页的表格会被检测并合并为单个表格(README 记录功能)。

当前版本是什么?

v4.2.2,2026 年 11 月 13 日发布(GitHub Releases),2026 年 11 月 15 日确认。

参考资料

← 返回 本地LLM进阶

MCP