mineru-pdf-parser
用 MinerU 将复杂PDF文档转换为LLM友好的Markdown/JSON格式。适用于:(1) PDF转Markdown/JSON,(2) 提取PDF中的文本、表格、公式、图像,(3) 解析学术论文、技术文档、商业报告,(4) 为RAG应用准备文档数据,(5) 批量处理PDF。触发关键词:"PDF解析"、"PDF转Markdown"、"提取PDF表格/公式"、"MinerU"、"parse PDF"等。不用于:PDF的阅读/填表/签名/拆分合并(用宿主pdf工具)、Word/PPT等非PDF格式解析、只需读几页内容的场景(直接读即可,不必转换)。
npx skills add staruhub/ClaudeSkills --skill Geek-skills-mineru-pdf-parser --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# MinerU PDF Parser 将复杂PDF文档转换为机器可读的Markdown/JSON格式,适用于LLM和RAG应用。 ## 安装 ```bash # 推荐使用uv安装 pip install uv uv pip install -U "mineru[all]" # 下载模型(首次使用) mineru-models-download ``` ## 快速使用 ### 命令行 ```bash # 解析单个PDF mineru -p input.pdf -o output_dir # 批量解析 mineru -p pdf_folder/ -o output_dir # 指定解析模式 mineru -p input.pdf -o output_dir --backend vlm # VLM模式(高精度) mineru -p input.pdf -o output_dir --backend pipeline # Pipeline模式(快速) mineru -p input.pdf -o output_dir --backend hybrid # 混合模式(平衡) ``` ### Python API ```python from mineru import MinerU mineru = MinerU() result = mineru.parse("document.pdf") # 获取输出 markdown = result.to_markdown() json_data = result.to_json() ``` 详细API见 [references/api_reference.md](references/api_reference.md) ## 解析模式选择 | 模式 | 特点 | 适用场景 | |------|------|----------| | `pipeline` | 快速、资源少 | 简单文档、纯文本PDF | | `vlm` | 高精度、复杂布局 | 学术论文、公式表格文档 | | `hybrid` | 平衡速度精度 | 通用场景 | ## 输出文件 - `{filename}.md` - Markdown正文 - `{filename}_content_list.json` - 结构化JSON - `images/` - 提取的图像 - `{filename}_middle.json` - 中间结果(调试) 格式详情见 [references/output_formats.md](references/output_formats.md) ## 最佳实践 ### 学术论文 ```bash mineru -p paper.pdf -o output --backend vlm ``` ### 批量处理 ```python fro
- 安装
- 快速使用
- 命令行
- Python API
- 解析模式选择
- 输出文件
- 最佳实践
- 学术论文
- 批量处理
- RAG数据准备
- 启用GPU加速
- 验收标准(解析任务完成前自查)
- 已知陷阱
- 脚本
pip install uv uv pip install -U "mineru[all]" mineru-models-download mineru -p input.pdf -o output_dir mineru -p pdf_folder/ -o output_dir mineru -p input.pdf -o output_dir --backend vlm # VLM模式(高精度) mineru -p input.pdf -o output_dir --backend pipeline # Pipeline模式(快速) mineru -p input.pdf -o output_dir --backend hybrid # 混合模式(平衡) mineru -p paper.pdf -o output --backend vlm
What does the mineru-pdf-parser skill do?
用 MinerU 将复杂PDF文档转换为LLM友好的Markdown/JSON格式。适用于:(1) PDF转Markdown/JSON,(2) 提取PDF中的文本、表格、公式、图像,(3) 解析学术论文、技术文档、商业报告,(4) 为RAG应用准备文档数据,(5) 批量处理PDF。触发关键词:"PDF解析"、"PDF转Markdown"、"提取PDF表格/公式"、"MinerU"、"parse PDF"等。不用于:PDF的阅读/填表/签名/拆分合并(用宿主pdf工具)、Word/PPT等非PDF格式解析、只需读几页内容的场景(直接读即可,不必转换)。
How do I install it?
Run `npx skills add staruhub/ClaudeSkills --skill Geek-skills-mineru-pdf-parser --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From staruhub/ClaudeSkills, a repository with 659 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.
