用途 pdf-converter 用于把文档转换为 Markdown 等结构化文本格式，适用于文档内容提取、论文阅读、扫描件识别与批量格式转换等场景。转换由 MinerU 开放 API（mineru.net）处理，属于无状态 API 调用，不持久化存储数据。MinerU 是由 OpenDataLab（上海人工智能实验室）开源的项目，地址为 https://github.com/opendatalab/MinerU 。
主要能力 支持两种提取模式。flash-extract 为快速模式，无需鉴权、无需 API key，默认使用；接受 PDF、图片（PNG、JPG、WebP 等）、DOCX、PPTX、Excel（XLS、XLSX），单文档限制 10 MB / 20 页，仅输出 Markdown，图片、表格和公式可能变为占位符。extract 为精确模式，需要鉴权；接受 PDF、图片、DOC、DOCX、PPT、PPTX、HTML，单文档限制 200 MB / 600 页，输出格式包括 md、json、html、latex、docx（用 -f 逗号分隔指定），默认启用公式识别与表格识别，支持 OCR 开关、批量模式与模型选择（vlm、pipeline、html）。
使用方式 flash-extract 常用命令： mineru-open-api flash-extract report.pdf mineru-open-api flash-extract report.pdf -o ./output/ mineru-open-api flash-extract report.pdf -o ./output/ --pages 1-10 mineru-open-api flash-extract report.pdf -o ./output/ --language en mineru-open-api flash-extract https://example.com/paper.pdf
extract 常用命令： mineru-open-api extract report.pdf mineru-open-api extract report.pdf -o ./out/ mineru-open-api extract report.pdf -o ./out/ -f md,docx mineru-open-api extract report.pdf -o ./out/ --ocr mineru-open-api extract *.pdf -o ./results/ mineru-open-api extract --list files.txt -o ./results/
使用 -o 可将结果保存到文件（适合转换、批处理等需要持久输出的情况）；立即消费内容（摘要、问答）时可省略 -o，直接读取 stdout。若尚未鉴权，需先运行 mineru-open-api auth 配置 token。
工作流说明 提取通常只是第一步。典型流程是：先用 mineru-open-api 将文档转为 Markdown，再由 AI 读取并处理用户实际需求。MinerU 输出原始 Markdown，不解释或重构内容；若用户要求“提取表格”“总结论文”“查找关键发现”，需要读取输出后自行完成。例如“帮我把这个PDF转成markdown”用 -o 保存文件；“提取这篇论文里的表格”先保存再读取并抽取表格；“这篇论文讲了什么”直接读 stdout 并总结；“把PDF里的参考文献整理出来”解析参考文献部分。
模式选择建议 “这个 PDF 说了什么”、快速摘要或内容浏览用 flash-extract；需要保留图片/表格/公式、文档超过 10 MB 或 20 页、批量转换多个文件、需要 DOCX/LaTeX/HTML 输出、扫描件需要 OCR 时用 extract（扫描件加 --ocr）。
语言支持 默认语言为 ch（中文+英文），可用 --language 指定其他语言。常见代码：en（英语）、japan（日语）、korean（韩语）、fr（法语）、chinese_cht（繁体中文）、de（德语）、es（西班牙语）、ru（俄语）、ar（阿拉伯语）、pt（葡萄牙语）、hi（印地语）、it（意大利语）、vi（越南语）、th（泰语）、tr（土耳其语）等，共支持 80 多种语言；未列出的语言可使用 PaddleOCR 的语言代码。
故障排查 调试 API 请求可加 -v 查看 HTTP 请求/响应详情；未找到 CLI 可通过 npm i -g mineru-open-api、uv tool install mineru-open-api 安装，或从 https://mineru.net/ecosystem?tab=cli 下载；extract 报鉴权错误时运行 mineru-open-api auth 设置 token；大文件超时可用 --timeout 600（秒）延长；输出语言不对时显式设置 --language。
限制 具体收费与价格信息暂未提供。两种模式均会发送文档至 MinerU API 处理。输出内容为原始 Markdown，结构化理解需额外处理。除上述已说明的限制外，其余平台兼容性、效果指标等信息暂未提供。