Github 趋势榜第一！开源 Agent 开发神器，任意文档转 JSON、MD

越来越多人发现，完整 AGI 的构建之路有一个离不开的基石：文档处理

大家好，我是含萧。

前段时间，DeepSeek-V3 的发布在国内外掀起一波盛赞，很多朋友都在讨论如何将其用于深度企业级搜索、Agent 开发和 RAG（Retrieval Augmented Generation）等场景。

笔者自然也想好好体验一把，但在实际测试中，我会发现，“文档处理” 是摆在我眼前的一道坎：

为什么文档处理如此重要？

在构建 Agent/RAG/LLM 应用的过程中，我们往往会面临以下痛点：

文档格式不统一
企业内部、外部知识库以及互联网公开资料中，可能同时存在 PDF、DOCX、PPTX、扫描图像等多种格式。LLM 需要的是可以被统一解析、结构化后的文本或特定语义切分，而原始文档格式差异过大，直接传给 LLM 识别往往得不到理想结果。
排版复杂 / 各种异常情况
可能遇到双栏、多栏排版；标题、页眉页脚穿插；大量表格、公式、图片；甚至整份文档都是扫描版图片……如果没有合适的文档解析工具，处理下来费时费力。
需求多样，输出格式不一
在 Agent 或 RAG 系统中，有时候需要 Markdown 用作呈现给用户；有时候需要 JSON 便于后端自动处理；或者还需要 CSV、XML 等。要想让文档处理结果“随取随用”，就需要一个能灵活导出多种结构化格式的解析工具。
对延迟和稳定性要求高
不论是做即时问答、Agent 聊天还是批量构建知识库，大家都很关心处理速度和稳定性。如果解析慢、或者报错崩溃，就无法在实际生产环境中稳定落地。

以上这几点组合在一起，就导致了一个尴尬的局面：如果文档的处理链路走不通，即便大模型本身能力再强，也难以在真实业务场景中充分发挥其价值。

就在这时，我发现 IBM 最新开源了一个文档解析神器——Docling，它仅需几行代码，就可以将各类文档都转换为 JSON/Markdown，发布至今已经狂揽 16.8k 星！

这意味着，我们可以在一个管道里搞定所有格式的文档处理，然后再将结果喂给大模型进行各种问答、聊天、Agent 流程、RAG 等应用。

论文地址：
https://arxiv.org/pdf/2408.09869

开源项目：
https://github.com/DS4SD/docling

Docling 的五大特点

多格式支持：无需为 PDF、DOCX、PPTX、图片等多种格式分别找工具，一个 Docling 统统搞定。
OCR 能力：针对扫描件也能精准提取文字，真正做到不遗漏任何重要信息。
页面布局/表格还原：可保留原文的排版信息、阅读顺序、表格行列结构，减少后续人工清洗的负担。
可与 LLM 集成：结合 LlamaIndex、LangChain 这类工具，能轻松实现自动问答、检索增强生成（RAG）等功能。
简单易用：Python 代码或 CLI 命令行，批量处理、单文件处理都能一键完成。

其中，docling 针对 pdf 有专门的处理逻辑：

Docling 的管道原理与核心流程

官方技术报告中介绍，Docling 整个处理流程大致分为以下阶段：

PDF/DOCX/PPT 等后端解析

对于 PDF：可选择他们自研的给予 qpdf 的 docling-parse 后端或者开源框架 pypdfium，也可以根据需要渲染 bitmap 图像，用于 OCR 视觉模型。
对于 DOCX/PPTX 等：可转换为标准化后的段落、图像元素、表格单元格、版面坐标等中间对象然后统一处理。

AI 模型推断

布局分析模型：识别段落、标题、列表、图片、表格等区块。
表格结构模型：对检测出的表格进行更细化的行列、单元格识别。
OCR 引擎（可选）：对扫描的页面进行文字识别。

后处理 & 组装

校正阅读顺序、匹配图片与标题、识别文档语言、补充元数据等。
最终组装得到可序列化的文档对象，支持 JSON、Markdown 等多种导出方式。

简而言之，Docling 在“文档格式 → 可用数据结构”的过程中做了大量底层工作，把文本、图片、表格都重新“拆装”了一遍。

同时，docling 可以通过简单几行代码就完成整个文档的处理，有超高的易用性。

比如，假设我们需要处理一个 pdf，只需要下面几行代码：




    
from docling.document_converter import DocumentConverter  
# PDF 文件可来自本地路径，也可直接是 URL  
source = "https://arxiv.org/pdf/2408.09869"  
converter = DocumentConverter()  
result = converter.convert(source)

# 输出文档的 Markdown 格式  
print(result.document.export_to_markdown())  
# 也可以这样输出 JSON  
import json  
doc_json = json.dumps(result.document.export_to_dict(), indent=4)  
print(doc_json)