Docling コンフィグレーター

オプションを選ぶと、実行可能なCLIコマンドと同等のPythonスニペットを生成します。フラグは現在の docling convert 構文に従います。必ず公式ドキュメントで確認してください。

  1. 1ConfigureChoose your options
  2. 2Preview & copyCLI + Python snippet
  3. 3Run locallyPaste or download the script
Input

PDF unlocks the OCR and table options below; other formats use their own backend automatically.

OCR & tables
OCRエンジンを有効化

Disabling OCR speeds up digital PDFs — keep it on for scans and photos.

Enrichment
コードブロックをエンリッチ
LaTeX数式をエンリッチ
グラフデータを抽出

Each option adds a model pass — enable only what your document contains.

Output & performance

Auto selects CUDA → MPS → CPU; tune threads to your machine.

CLIコマンド

bash

Pythonの等価コード

python
1
???? 1

ジェネレーターの使い方

このジェネレーターは、選択内容からすぐにコピーできる 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. 実行して出力を確認 変換後のファイルは既定で元ファイルの隣に書き出されます。
2
???? 2

入力形式

最も近いものを選んでください。OCR と表のオプションが影響するのは PDF と画像のみで、それ以外は形式ごとのバックエンドで自動処理されます。

入力拡張子OCR の適用備考
PDF.pdfあり(任意)レイアウト、読み順、表。このツールの主な用途です。
Word.docx, .docなし見出し、リスト、表が保持されます。
PowerPoint.pptxなしスライド、テキストボックス、ノート。
Excel.xlsxなし各シートが構造化された表になります。
HTML.html, .htmなしWeb ページと保存済み HTML。
Audio.mp3, .wavなしASR パイプラインを使用。OCR オプションは適用されません。
3
???? 3

OCR オプション

OCR は画像上の文字を機械可読なテキストに変換します。精度と実行時間に最も大きく影響するため、意図的に有効化してください。

  • スキャン、写真、選択可能なテキスト層のない PDF では OCR を有効にします。
  • デジタル PDF では OCR を無効にします。変換が数倍速くなる場合があります(--no-ocr)。
  • モード default は既存テキストを保持し、テキストのないページだけを OCR します。
  • モード full_page は全ページを OCR し、検出したテキストを上書きします。
エンジンプラットフォーム最適な用途備考
autoすべてDocling に任せる既定値で最も安全な出発点。
RapidOCRクロスプラットフォームCPU 向け多言語 OCRONNX ベースで重い依存関係がありません。
Tesseract (tesserocr)クロスプラットフォーム(システムバイナリ)多言語対応の成熟した OCRTesseract 本体と言語データが必要です。
EasyOCRクロスプラットフォーム簡単なセットアップ初回利用時に独自モデルをダウンロードします。
OcrMacmacOS のみApple Vision ネイティブ OCRmacOS でのみ利用できます。
Nemotron OCRLinux + CUDAGPU 加速 OCR対応する CUDA 環境が必要です。
4
???? 4

表の抽出

表は生テキストではなくレイアウトから再構築されるため、選択したモードが結果の品質を左右します。

モードモデル精度速度使う場面
accurateTableFormer遅い結合セル、罫線のない表、財務レポート。
fast高速構造モデルおおよそ速いおおまかな表で十分で速度を優先する場合。
5
???? 5

エンリッチメント

エンリッチメントは特殊な内容を検出するニューラル後処理を追加します。文書に実際に含まれる場合のみ有効にしてください。

オプション抽出対象有効にする場面コスト
--enrich-codeコードブロック技術文書や開発者向け文書。追加のモデル実行
--enrich-formulaLaTeX 数式科学・学術 PDF。追加のモデル実行
--enrich-chart-extractionグラフデータグラフを含むレポート。追加のモデル実行
6
???? 6

出力形式

結果をどう使うかを選んでください。プレビューは Python スニペットのエクスポート呼び出しも更新します。

形式得られるもの最適な用途
Markdown (md)表を含む読みやすいテキストメモ、ドキュメント、RAG 用テキスト。
Docling JSON (json)バウンディングボックス付きのロスレス DoclingDocument独自パイプラインと後段処理。
HTML (html)HTML としての表とレイアウトWeb プレビューとメール。
DocTags (doctags)コンパクトなトークン形式マークアップモデル入力とトークン処理。
7
???? 7

アクセラレーターとスレッド

Docling は CPU、NVIDIA GPU(CUDA)、Apple Silicon(MPS)で動作します。auto は CUDA、次に MPS、次に CPU を選択します。

  • 大規模バッチでは NVIDIA ハードウェアで --device cuda を使用します。
  • Apple Silicon では --device mps を使用します。
  • CPU では不要な OCR とエンリッチメントを無効にします。
設定効果
--deviceauto, cuda, mps, cpuニューラル推論の実行場所を指定します。
--num-threads整数(既定 4)CPU 並列度。スレッドが多すぎると小さなマシンでは遅くなることがあります。
8
???? 8

生成されるフラグのリファレンス

生成器が出力できるフラグと、対応する Python オプションを示します。CLI の全範囲は CLI リファレンス を参照してください。

フラグ適用対象Python 相当
--tomd, json, html, doctagsすべてexport_to_markdown(), export_to_dict(), export_to_html(), export_to_doctags()
--ocr-engineauto, rapidocr, tesserocr, easyocr, ocrmac, nemotron-ocrPDF と画像pipeline_options.ocr_options
--ocr-modedefault, full_pagePDF と画像pipeline_options.ocr_options
--no-ocrフラグPDFpipeline_options.do_ocr = False
--table-modeaccurate, fastPDFpipeline_options.do_table_structure
--enrich-codeフラグPDFpipeline_options.do_code_enrichment
--enrich-formulaフラグPDFpipeline_options.do_formula_enrichment
--enrich-chart-extractionフラグPDFpipeline_options.do_chart_extraction
--deviceauto, cuda, mps, cpuすべてAcceleratorOptions(device=...)
--num-threads整数すべてAcceleratorOptions(num_threads=...)
9
???? 9

Python 相当のコード

生成器はこのスニペットを作成します。PDF では PdfPipelineOptions を構成し format_options で登録します。その他の形式では単純な DocumentConverter() で十分です。

  • ロスレス JSON を得るには export_to_markdown()export_to_dict() に置き換えます。
  • OCR を無効にするには pipeline_options.do_ocr = False を設定します。
  • 複数ファイルを処理するには 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())
10
???? 10

レシピ

プリセットをコピーしてファイル名を変更してください。

デジタル PDF(最速)

OCR なし、Markdown 出力。

docling convert report.pdf --to md --no-ocr
スキャン PDF

全ページ OCR の後に Markdown。

docling convert scan.pdf --to md --ocr-mode full_page
学術論文

数式とコードをエンリッチ。

docling convert paper.pdf --to md --enrich-code --enrich-formula
機械可読な構造

ロスレス Docling JSON。

docling convert report.pdf --to json
Office 文書

Word、PowerPoint、Excel。

docling convert workbook.xlsx --to md
GPU バッチ

より多いスレッドで CUDA。

docling convert report.pdf --to md --device cuda --num-threads 8
11
???? 11

生成器が表示する警告

生成器は組み合わせを検証し、効果がない選択を警告します。通常と異なるフラグは必ず公式 CLI リファレンスで確認してください。

  • 音声入力で OCR が有効(OCR は ASR パイプラインには適用されません)。
  • macOS 以外で OcrMac を選択。
  • CPU で Nemotron OCR を選択。
  • OCR を無効にしたのに OCR エンジンが選択されたまま。
12
???? 12

パフォーマンスとプライバシー

生成器は完全にブラウザー内で動作し、生成されたコマンドは Docling をローカルで実行します。

  • デジタル PDF では OCR を無効にし、スキャンのみで有効にします。
  • おおまかな表でよい場合は --table-mode fast を使います。
  • 大規模バッチでは GPU を優先し、--num-threads をマシンに合わせます。
  • 何もアップロードされません。選択内容がブラウザーから出ることはありません。
13
???? 13

さらに詳しく

関連ツールとリファレンス。

14
???? 14

よくある質問

生成されたコマンドはそのまま実行できますか?
はい。現在の docling convert 構文と選択したオプションのみを使用します。一度確認してからご自身の環境で実行してください。
生成器は文書や設定をアップロードしますか?
いいえ。すべてブラウザー内でローカルに計算され、サーバーには何も送信されません。生成されたコマンドはお使いのマシンで Docling を実行します。
どの OCR エンジンを選べばよいですか?
まずは auto から。CPU のみのマシンでは RapidOCR が適しています。macOS では OcrMac、Nemotron OCR は CUDA GPU でのみ使用してください。
生成される Python が CLI と異なるのはなぜですか?
CLI は内部的にフラグをパイプラインオプションへ割り当てます。Python スニペットはその対応を明示し、さらに調整できるようにします。
GPU は必要ですか?
いいえ。Docling は CPU で動作します。GPU は主に大きな文書での OCR とエンリッチメントを高速化します。
Windows、macOS、Linux で同じコマンドを使えますか?
はい。同じコマンドがすべてのプラットフォームで動作します。異なるのは OCR エンジンの利用可否だけです(OcrMac は macOS のみ、Nemotron OCR は CUDA が必要)。
Markdown ではなく RAG 用のチャンクを得るには?
Markdown または JSON を出力し、その結果を HybridChunker に渡します。RAG ガイド を参照してください。
フラグは常に最新ですか?
最後に確認した時点の docling convert インターフェースに従います。通常と異なるオプションは公式 CLI リファレンスで確認してください。