Docling コンフィグレーター
オプションを選ぶと、実行可能なCLIコマンドと同等のPythonスニペットを生成します。フラグは現在の docling convert 構文に従います。必ず公式ドキュメントで確認してください。
- 1ConfigureChoose your options
- 2Preview & copyCLI + Python snippet
- 3Run locallyPaste or download the script
オプションを選ぶと、実行可能なCLIコマンドと同等のPythonスニペットを生成します。フラグは現在の docling convert 構文に従います。必ず公式ドキュメントで確認してください。
このジェネレーターは、選択内容からすぐにコピーできる docling convert コマンドと、同等の Python スニペットを生成します。このガイドでは、各オプションの意味、生成されるフラグと Python API の対応、安全な実行方法を説明します。
上から順に設定してください。どのコントロールを変更してもプレビューが更新されます。
auto を使い、必要なときだけ特定のエンジンを選びます。accurate、速度優先なら fast を使います。最も近いものを選んでください。OCR と表のオプションが影響するのは PDF と画像のみで、それ以外は形式ごとのバックエンドで自動処理されます。
| 入力 | 拡張子 | OCR の適用 | 備考 |
|---|---|---|---|
.pdf | あり(任意) | レイアウト、読み順、表。このツールの主な用途です。 | |
| Word | .docx, .doc | なし | 見出し、リスト、表が保持されます。 |
| PowerPoint | .pptx | なし | スライド、テキストボックス、ノート。 |
| Excel | .xlsx | なし | 各シートが構造化された表になります。 |
| HTML | .html, .htm | なし | Web ページと保存済み HTML。 |
| Audio | .mp3, .wav | なし | ASR パイプラインを使用。OCR オプションは適用されません。 |
OCR は画像上の文字を機械可読なテキストに変換します。精度と実行時間に最も大きく影響するため、意図的に有効化してください。
--no-ocr)。default は既存テキストを保持し、テキストのないページだけを OCR します。full_page は全ページを OCR し、検出したテキストを上書きします。| エンジン | プラットフォーム | 最適な用途 | 備考 |
|---|---|---|---|
auto | すべて | Docling に任せる | 既定値で最も安全な出発点。 |
| RapidOCR | クロスプラットフォーム | CPU 向け多言語 OCR | ONNX ベースで重い依存関係がありません。 |
| Tesseract (tesserocr) | クロスプラットフォーム(システムバイナリ) | 多言語対応の成熟した OCR | Tesseract 本体と言語データが必要です。 |
| EasyOCR | クロスプラットフォーム | 簡単なセットアップ | 初回利用時に独自モデルをダウンロードします。 |
| OcrMac | macOS のみ | Apple Vision ネイティブ OCR | macOS でのみ利用できます。 |
| Nemotron OCR | Linux + CUDA | GPU 加速 OCR | 対応する CUDA 環境が必要です。 |
表は生テキストではなくレイアウトから再構築されるため、選択したモードが結果の品質を左右します。
| モード | モデル | 精度 | 速度 | 使う場面 |
|---|---|---|---|---|
accurate | TableFormer | 高 | 遅い | 結合セル、罫線のない表、財務レポート。 |
fast | 高速構造モデル | おおよそ | 速い | おおまかな表で十分で速度を優先する場合。 |
エンリッチメントは特殊な内容を検出するニューラル後処理を追加します。文書に実際に含まれる場合のみ有効にしてください。
| オプション | 抽出対象 | 有効にする場面 | コスト |
|---|---|---|---|
--enrich-code | コードブロック | 技術文書や開発者向け文書。 | 追加のモデル実行 |
--enrich-formula | LaTeX 数式 | 科学・学術 PDF。 | 追加のモデル実行 |
--enrich-chart-extraction | グラフデータ | グラフを含むレポート。 | 追加のモデル実行 |
結果をどう使うかを選んでください。プレビューは Python スニペットのエクスポート呼び出しも更新します。
| 形式 | 得られるもの | 最適な用途 |
|---|---|---|
Markdown (md) | 表を含む読みやすいテキスト | メモ、ドキュメント、RAG 用テキスト。 |
Docling JSON (json) | バウンディングボックス付きのロスレス DoclingDocument | 独自パイプラインと後段処理。 |
HTML (html) | HTML としての表とレイアウト | Web プレビューとメール。 |
DocTags (doctags) | コンパクトなトークン形式マークアップ | モデル入力とトークン処理。 |
Docling は CPU、NVIDIA GPU(CUDA)、Apple Silicon(MPS)で動作します。auto は CUDA、次に MPS、次に CPU を選択します。
--device cuda を使用します。--device mps を使用します。| 設定 | 値 | 効果 |
|---|---|---|
--device | auto, cuda, mps, cpu | ニューラル推論の実行場所を指定します。 |
--num-threads | 整数(既定 4) | CPU 並列度。スレッドが多すぎると小さなマシンでは遅くなることがあります。 |
生成器が出力できるフラグと、対応する Python オプションを示します。CLI の全範囲は CLI リファレンス を参照してください。
| フラグ | 値 | 適用対象 | Python 相当 |
|---|---|---|---|
--to | md, json, html, doctags | すべて | export_to_markdown(), export_to_dict(), export_to_html(), export_to_doctags() |
--ocr-engine | auto, rapidocr, tesserocr, easyocr, ocrmac, nemotron-ocr | PDF と画像 | pipeline_options.ocr_options |
--ocr-mode | default, full_page | PDF と画像 | pipeline_options.ocr_options |
--no-ocr | フラグ | pipeline_options.do_ocr = False | |
--table-mode | accurate, fast | pipeline_options.do_table_structure | |
--enrich-code | フラグ | pipeline_options.do_code_enrichment | |
--enrich-formula | フラグ | pipeline_options.do_formula_enrichment | |
--enrich-chart-extraction | フラグ | pipeline_options.do_chart_extraction | |
--device | auto, cuda, mps, cpu | すべて | AcceleratorOptions(device=...) |
--num-threads | 整数 | すべて | AcceleratorOptions(num_threads=...) |
生成器はこのスニペットを作成します。PDF では PdfPipelineOptions を構成し format_options で登録します。その他の形式では単純な DocumentConverter() で十分です。
export_to_markdown() を export_to_dict() に置き換えます。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())
プリセットをコピーしてファイル名を変更してください。
OCR なし、Markdown 出力。
docling convert report.pdf --to md --no-ocr全ページ 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 jsonWord、PowerPoint、Excel。
docling convert workbook.xlsx --to mdより多いスレッドで CUDA。
docling convert report.pdf --to md --device cuda --num-threads 8生成器は組み合わせを検証し、効果がない選択を警告します。通常と異なるフラグは必ず公式 CLI リファレンスで確認してください。
生成器は完全にブラウザー内で動作し、生成されたコマンドは Docling をローカルで実行します。
--table-mode fast を使います。--num-threads をマシンに合わせます。docling convert 構文と選択したオプションのみを使用します。一度確認してからご自身の環境で実行してください。auto から。CPU のみのマシンでは RapidOCR が適しています。macOS では OcrMac、Nemotron OCR は CUDA GPU でのみ使用してください。HybridChunker に渡します。RAG ガイド を参照してください。docling convert インターフェースに従います。通常と異なるオプションは公式 CLI リファレンスで確認してください。