Docling 配置器

生成器会把你的选择转换为可直接复制的 docling convert 命令和等效的 Python 代码片段。本指南说明每个选项的作用、生成的参数如何对应 Python API，以及如何安全地运行结果。

从上到下依次设置；更改任意控件后预览都会更新。

1. 选择输入格式 与文件匹配的格式。它只改变 PDF 的输入处理；其他格式会自动使用各自的后端。
2. 决定是否使用 OCR 扫描件和照片保持开启，数字版 PDF 关闭可显著加快转换。
3. 选择 OCR 引擎和模式 仅在启用 OCR 时。建议先用 auto，确有需要再选具体引擎。
4. 选择表格模式 复杂表格用 accurate，更看重速度时用 fast。
5. 只启用需要的增强功能 代码、公式和图表各自都会增加神经处理。
6. 选择输出格式和加速器 阅读用 Markdown，结构化用 JSON；只有确有 GPU 时再选。
7. 复制或下载脚本 使用 复制 CLI、复制 Python 或 下载脚本 (.sh)。
8. 运行并检查输出 默认情况下转换后的文件会写在源文件旁边。

选择最接近的一项。只有 PDF 和图片输入受 OCR 与表格选项影响；其他格式会自动走各自的专用后端。

OCR 会把图片上的文字转换为机器可读文本。它是影响精度和运行时间最大的因素，请按需谨慎启用。

• 扫描件、照片或没有可选中文本层的 PDF 应启用 OCR。
• 数字版 PDF 应关闭 OCR，转换速度可提升数倍（--no-ocr）。
• default 模式保留已有文本，只对缺少文本的页面执行 OCR。
• full_page 模式对每一页执行 OCR 并覆盖检测到的文本。

表格是根据版式而非原始文本重建的，因此所选模式会影响结果质量。

增强会添加神经后处理以识别专门内容。只有当文档确实包含这些内容时才启用。

选择你想如何使用结果；预览也会同步更新 Python 代码片段中的导出调用。

Docling 可在 CPU、NVIDIA GPU（CUDA）和 Apple Silicon（MPS）上运行。auto 会依次选择 CUDA、MPS、CPU。

• 大批量处理时，在 NVIDIA 硬件上使用 --device cuda。
• 在 Apple Silicon 上使用 --device mps。
• 在 CPU 上关闭不需要的 OCR 和增强功能。

以下是生成器可输出的参数及其对应的 Python 选项。完整 CLI 请参阅 CLI 参考。

生成器会为你构建此代码片段。对于 PDF，它会配置 PdfPipelineOptions 并通过 format_options 注册；其他格式只需简单的 DocumentConverter()。

• 将 export_to_markdown() 换成 export_to_dict() 可获得无损 JSON。
• 设置 pipeline_options.do_ocr = False 可关闭 OCR。
• 使用 convert_all() 可批量处理多个文件。

from docling.document_converter import DocumentConverter, PdfFormatOption
from docling.datamodel.base_models import InputFormat
from docling.datamodel.pipeline_options import PdfPipelineOptions

pipeline_options = PdfPipelineOptions()
pipeline_options.do_ocr = True
pipeline_options.do_table_structure = True

converter = DocumentConverter(
    format_options={InputFormat.PDF: PdfFormatOption(pipeline_options=pipeline_options)}
)

result = converter.convert("report.pdf")
print(result.document.export_to_markdown())

复制预设并修改文件名即可。

生成器会检查组合，并在某个选择不会生效时给出警告。对于不常见的参数，请务必对照官方 CLI 参考确认。

• 选择音频输入但 OCR 仍开启（OCR 不适用于 ASR 流水线）。
• 在非 macOS 平台选择了 OcrMac。
• 在 CPU 上选择了 Nemotron OCR。
• 已关闭 OCR 但仍选择了某个 OCR 引擎。

生成器完全在浏览器中运行，生成的命令会在本地执行 Docling。

• 数字版 PDF 关闭 OCR，仅扫描件保留。
• 可接受近似表格时使用 --table-mode fast。
• 大批量处理优先使用 GPU，并根据机器调整 --num-threads。
• 不会上传任何内容：你的选择不会离开浏览器。

相关工具与参考。

• 命令查找：可直接复制的 docling convert 命令。
• OCR 引擎：对比引擎与平台支持。
• 支持的格式：Docling 可读写的格式。
• 示例：面向任务的 CLI 与 Python 配方。
• RAG 指南：分块与向量库。
• 技术参考：SDK、流水线和完整 CLI。