PDF转Markdown用MinerU还是Marker?六款开源工具对比
围绕PDF转Markdown选型,文章给出PDF.cn在线转换、桌面软件与MinerU本地命令行、开源解析器批量编排三条路线,并对比MinerU、Marker等六款工具,说明扫描件OCR、复杂公式表格、批量处理和结果核对要点,帮助减少乱码、层级错乱与图片遗漏。
如果重点是中文论文、公式、表格和复杂版面,MinerU通常更值得先试;如果文件以清晰文本和常规层级为主,并且更看重本地批量流程,Marker更合适。只是偶尔转换单个文件时,不必先搭建开源环境,直接使用PDF转Markdown会更省步骤。无论选择哪条路线,都应抽查标题层级、代码块、表格、公式和图片引用,不能默认复杂排版会被百分之百还原。
方法一:使用PDF转Markdown在线处理单个文件
这条路线适合临时处理文字型PDF、不想安装环境或只需转换少量文件的情况。扫描件仍可能需要先做OCR;多栏论文、复杂公式和跨页表格转换后也要人工复核。
- 进入极轻PDF首页,在PDF转换分类中找到对应入口,先确认转换方向是从PDF生成Markdown。

找到工具入口
进入转换页后点击选择文件,从本机加入待处理的PDF。上传前可先打开原文件,确认它没有损坏、加密限制或空白页面。

选择并上传文件
文件进入列表后,核对文件名、大小和上传状态。若名称或大小明显不符,应先删除错误文件,再重新选择,避免转换了旧版本或同名文件。

核对上传状态
确认上传成功后开始转换。页面没有需要修改的选项时可直接处理;若实际页面提供可选项,则按文档页数和内容类型谨慎设置,不要凭经验套用其他工具的参数。

设置参数并开始处理
任务显示完成后下载Markdown文件。建议使用文本编辑器打开结果,并与原PDF逐页抽查:一级和二级标题是否混乱、列表是否断行、图片引用是否有效、表格是否缺列,以及公式有没有变成不可读字符。

下载结果并检查
方法二:桌面软件或MinerU命令行处理本地单文件
本地路线适合文件不便上传、需要限定页面范围,或者希望把转换动作纳入自己的工作目录。桌面软件更适合少量文件和可视化操作;MinerU命令行更适合熟悉终端、需要重复执行同一流程的用户。
步骤1:在支持生成Markdown的桌面软件中打开PDF,进入相应转换面板。根据实际需要核对页面范围和输出文件夹,再执行转换;不要把截图中的界面选项套用到名称不同的软件。

核对转换页码与Markdown输出位置
步骤2:选择MinerU时,先在其文档中确认当前环境支持的命令和参数,再用一个短PDF做小样。命令执行后应保留生成目录,不要只看终端是否结束;重点检查Markdown正文、图片目录及可能附带的结构化结果是否对应同一份源文件。

根据MinerU文档确认命令参数和输出文件
完成检查:分别抽查首页、目录页、正文中段和公式或表格密集页。如果正文顺序与阅读顺序不一致,可先调整分栏识别或页面范围;如果整页只有图片而没有文本,应转入带OCR的路线。命令行方案还要检查相对图片路径,移动Markdown文件时需同步移动资源目录。
方法三:用开源解析器和工作流编排处理批量或复杂PDF
当文件数量多、版式差异大,或需要把解析结果继续交给知识库和内容系统时,可以先用开源解析器做样本测试,再接入批处理工作流。MinerU与Marker都属于这一选型范围:前者可优先用于中文复杂文档试验,后者可用于偏文本型文件的本地结构化转换,但最终选择仍应以自己的样本结果为准。
步骤1:从待处理文件中挑选一份具有代表性的PDF,在演示或测试界面限制转换页数,先观察预览、Markdown渲染和纯文本结果。测试样本应包含至少一个标题层级、一张图片,并尽量覆盖表格或公式。

用代表性页面测试解析与Markdown渲染结果
步骤2:样本通过后,再把读取文件、解析、结果检查和写入文件拆成独立节点。可视化工作流或脚本都应保留失败分支和日志,避免某个PDF解析失败后仍被当成成功结果写入下游目录。

编排读取、解析、检查与输出节点
完成检查:批量任务至少记录源文件名、处理状态、输出路径和失败原因,并随机抽查不同版式的结果。扫描件要先确认OCR文字是否完整;复杂论文要单独检查公式、脚注、双栏阅读顺序和跨页表格。任何解析器都可能需要后处理,不应把自动生成的Markdown未经核对就直接发布。
六款开源工具怎么选
| 工具 | 更适合的PDF | 使用前要确认 |
|---|---|---|
| MinerU | 中文论文、公式表格较多或版面较复杂的文档 | 先用样本核对阅读顺序、公式和图片目录 |
| Marker | 文字清晰、层级明确并准备在本地批量处理的文件 | 检查中文断行、表格和公式是否需要后处理 |
| Docling | 需要结构化结果并继续接入文档处理流程的PDF | 确认输出结构是否适配下游字段 |
| PyMuPDF4LLM | 文本层完整、以段落提取为主的常规PDF | 扫描页通常还需OCR,复杂布局需额外抽查 |
| PaddleOCR | 扫描件、图片型PDF及中文识别场景 | OCR结果仍需重建标题层级和Markdown结构 |
| Nougat | 论文及公式内容较多的实验性转换任务 | 用真实样本评估环境需求和公式准确度 |
简单来说,MinerU和Marker并非绝对的替代关系。中文复杂版面先测MinerU,清晰文本和本地批量可先测Marker;扫描件应把OCR能力放在首位,普通文本层PDF则可以优先考虑更轻量的解析路线。
转换结果排查表
| 问题 | 优先排查 | 处理方向 |
|---|---|---|
| 输出几乎为空 | 原PDF是否只有扫描图片 | 先做OCR,再重建Markdown层级 |
| 双栏内容串行 | 阅读顺序和版面解析结果 | 更换解析器或分段校正 |
| 图片显示失败 | Markdown中的相对路径 | 保持正文与资源目录的相对位置 |
| 表格缺列或错位 | 合并单元格、跨页表格 | 改用HTML表格或人工整理关键数据 |
| 公式变成乱码 | 公式识别与字符编码 | 保留原页对照,逐式检查并修订 |
常见问题
PDF转成Markdown后能完全保留排版吗?
不能保证。Markdown擅长表达标题、段落、列表和代码块,但复杂分页、浮动元素、跨页表格及精细视觉布局通常需要重新整理。
扫描版PDF应该直接用MinerU还是Marker?
先确认工具链是否能完成OCR,并用包含印章、表格和低清文字的样本测试。若识别文字本身错误,后续Markdown结构再整齐也没有意义。
批量转换时最容易遗漏什么?
常见遗漏包括失败文件未记录、图片目录未同步、同名输出被覆盖,以及只检查任务状态而没有抽查实际内容。建议为每个源文件保留独立输出目录和处理日志。
参考来源与相关工具
选型时先拿自己的典型PDF做小样,比只看工具名称更可靠。后续还可以关注极轻 PDF 网站的文档处理内容,根据文件是否含文本层、OCR需求和批量规模调整转换路线。
火山引擎是字节跳动旗下企业级云与AI服务平台。聚焦大模型核心能力,依托字节自研豆包多模态大模型,凭借火山方舟一站式平台,提供模型精调、推理部署、智能应用搭建等全链路服务,结合高性能AI算力,助力各行业快速落地大模型数字化与智能化应用。
















