MinerU：PDF 解析与文档转换指南

MinerUPDF 解析与文档转换指南【免费下载链接】MinerUTransforms complex documents like PDFs and Office docs into LLM-ready markdown/JSON for your Agentic workflows.项目地址: https://gitcode.com/GitHub_Trending/mi/MinerU手头有一份含公式和表格的扫描 PDF需要转成可检索的 Markdown 喂给 RAG 系统MinerU 就是做这件事的开源工具PDF 解析后直接输出结构化的 Markdown 与 JSON。本文覆盖 MinerU 文档转换的安装步骤、后端选择和常见问题排查。项目是什么MinerU 是面向大模型、RAG 与 Agent 场景的开源文档解析工具把 PDF、图片和 DOCX / PPTX / XLSX 转成机器可读格式便于检索、抽取与二次处理。能力点如下原生解析 PDF、图片、DOCX、PPTX、XLSX自动识别扫描件并启用 OCR公式自动转成 LaTeX表格转成 HTML保留标题、段落、列表结构输出按人类阅读顺序排列自动去除页眉、页脚、页码OCR 支持 109 种语言的检测与识别提供命令行、FastAPI、Gradio WebUI 与 Docker 部署方式兼容 Windows、Linux、macOS可纯 CPU 运行三分钟上手安装使用 uv 即可mineru[all]包含全部核心功能uv pip install -U mineru[all]首次运行会自动下载所需模型之后走本地缓存。仓库自带示例文档直接试mineru -p demo/pdfs/demo1.pdf -o output没有 GPU 或显存不足时指定 pipeline 后端即可在纯 CPU 环境跑通。它如何工作解析过程分三步预处理读取文档页面区分文本型与扫描型决定走直接抽取还是 OCR。模型分析版面检测识别标题、正文、公式、表格区域再逐区域做文字识别、公式识别和表格结构识别。结果转换按阅读顺序组织内容公式落为 LaTeX、表格落为 HTML写出 Markdown 与 JSON。典型使用场景个人阅读把 PDF 论文转成带 LaTeX 公式的 Markdown便于本地编辑和全文检索。扫描件、多栏排版的论文也可以直接丢进去无需手动整理结构。团队协作通过 Gradio WebUI 做可视化解析配合 layout、span 可视化结果核对输出质量。多人共用一台解析服务器时用 FastAPI 接口统一提交任务即可。自动化流水线命令行支持目录输入适合批量转换存量文档。生产环境可部署 API 服务并用 mineru-router 做多 GPU 任务路由为 RAG 知识库持续供给结构化数据。常见问题排查现象模型下载失败或很慢。默认模型托管在 huggingface无法访问时切换到国内镜像源export MINERU_MODEL_SOURCEmodelscope现象Windows 直接安装后推理速度很慢。多为 CUDA 加速依赖未正确安装。按显卡架构到 PyTorch 官网选择对应命令安装支持 CUDA 的 torch 与 torchvisionRTX 50 系显卡则需安装 cu128 版本的 lmdeploy wheel。现象Linux 上解析结果缺失部分中文文字。通常是系统缺少 CJK 字体渲染 PDF 页面时丢字。安装字体包后刷新字体缓存sudo apt install fonts-noto-core fonts-noto-cjk fc-cache -fv后端按环境选精度分数来自 OmniDocBench v1.6 端到端评测后端适用环境精度分数说明pipeline纯 CPU 或 GPU显存 4GB86.47兼容性好无幻觉hybrid / vlm-engineGPU显存 8GB95.39精度更高硬件要求高*-http-client对接 OpenAI 兼容推理服务器95.30本地只需 2GB 磁盘适合集中部署继续深入后端解析主逻辑mineru/backend/pipeline、hybrid、vlm 三个子目录布局、公式、表格模型实现mineru/model/CLI 与服务入口mineru/cli/fast_api.py、gradio_app.py、router.py官方文档入口docs/zh/index.md常见问题在 docs/zh/faq/index.md端到端测试用例tests/unittest/test_e2e.py【免费下载链接】MinerUTransforms complex documents like PDFs and Office docs into LLM-ready markdown/JSON for your Agentic workflows.项目地址: https://gitcode.com/GitHub_Trending/mi/MinerU创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考