独立系ガイド — IBM および Docling プロジェクトとは無関係です。 すべてのコマンドを Docling 2.148.0 で検証済み。
docling.org独立系 Docling ガイド
  1. ホーム
  2. CLI リファレンス
CLI リファレンス

Docling CLI リファレンス——すべてのオプションをツール自体から

このリファレンスは Docling 2.148.0 の CLI 自身のパラメーター定義を読み取って生成しています。名前・既定値・選択肢はターミナルが実際に受け付けるものと同じです。検索して、検証済みのコマンドをコピーしてください。

Docling で検証済み 2.148.0更新日 2026年11月6日10 分で読めます
要点
  • 構文：docling convert [OPTIONS] SOURCE。SOURCE はファイル・フォルダ・URL。convert は既定のコマンドなので docling SOURCE でも動きます。
  • 出力は繰り返し指定できる --to で選択（md・json・yaml・html・html_split_page・text・doctags・vtt・doclang・dclx・chunks・latex）。既定はカレントフォルダへの Markdown。
  • エンジン固有の設定は --ocr-option・--layout-option・--table-structure-option に KEY=VALUE で渡します。キーは docling options ocr rapidocr で確認できます。
  • 2.144.0 以降の新オプション：--replace-broken-text-layer（PDF テキストが文字化けしたページだけ OCR）と --heading-hierarchy（PDF の見出しレベルを推定）。
  • 2.148.0 では --force-ocr と --psm は非推奨。--ocr-mode full_page と --ocr-option psm=N を使います。

すべてのオプションを検索#

キーワードを入力するか（/ で検索欄に移動）、グループで絞り込みます。既定値は CLI 自身のもので、コード表記の値が受け付けられる選択肢です。説明文はターミナルの表示と同じ英語の原文のままです。

構文#

bash
docling convert [OPTIONS] SOURCE
docling SOURCE [OPTIONS]                # 同じ意味（convert が既定のコマンド）
docling options {ocr|layout|table-structure} [ENGINE]
docling --version

SOURCE にはファイルパス、フォルダ（再帰的にたどり --from で絞り込み）、http(s) の URL を指定できます。出力ファイルは入力名に基づいて --output（既定はカレントフォルダ）に書き出されます。

検証済みのコマンド例#

いずれも Docling 2.148.0 で実行しました。ファイル名はご自身のものに置き換えてください。

形式と出力

bashPDF を Markdown と JSON に
docling convert report.pdf --to md --to json --output out/
bashフォルダ全体、PDF のみ、エラーでも続行
docling convert ./inbox --from pdf --to md --output ./out
bash出力ファイル名を指定（入力 1 つ・形式 1 つ）
docling convert report.pdf --to md --output-file report.md
bash最初の 10 ページだけ
docling convert report.pdf --page-range 1-10
bash画像を PNG ファイルとして report_artifacts フォルダに保存し、Markdown からリンク
docling convert report.pdf --to md --image-export-mode referenced --output out/
bash検出したレイアウトを描画した左右並びの HTML
docling convert report.pdf --to html_split_page --show-layout

OCR

bashデジタル生成 PDF：OCR を省略（最速）
docling convert report.pdf --no-ocr
bashテキスト層が壊れたスキャン：全ページ OCR
docling convert scan.pdf --ocr-mode full_page
bashPDF のテキストが文字化け：壊れたページだけ OCR
docling convert contract.pdf --replace-broken-text-layer
bash日本語のスキャン：RapidOCR（標準インストールのまま、PyTorch バックエンド）
docling convert scan.pdf --ocr-engine rapidocr --ocr-option backend=torch --ocr-lang iso:ja
bashTesseract で日本語と英語
docling convert scan.pdf --ocr-engine tesseract --ocr-lang jpn,eng

表・拡張・モデル

bash高速な表モデル
docling convert report.pdf --table-mode fast
bashしおり・番号・フォントサイズから見出しレベル（#・##・###）を推定
docling convert report.pdf --heading-hierarchy
bash数式を LaTeX に、コードブロックも認識
docling convert paper.pdf --enrich-formula --enrich-code
bashGranite-Docling による視覚言語パイプライン（GPU 推奨）
docling convert report.pdf --pipeline vlm --vlm-model granite_docling
bash音声の文字起こし（docling[asr] と FFmpeg が必要）
docling convert meeting.mp3 --pipeline asr --asr-model whisper_turbo --to md --to vtt

RAG と自動化

bashベクトル DB 用のトークン制限付きチャンク
docling convert report.pdf --to chunks --chunks-max-tokens 512 --output chunks/
bash静かに実行し、部分的な結果も失敗扱い（スクリプト・CI 向け）
docling convert ./inbox --to json --quiet --fail-on partial --output ./out
bash時間の内訳を見る
docling convert report.pdf --profiling

options コマンド#

エンジンには専用オプション以外の設定もあります。docling options でステージごとのエンジンと受け付けるキーを一覧し、対応する --*-option KEY=VALUE で渡します。値は可能なら JSON として解釈されます（0.6、false、["en","de"]）。

bash
docling options ocr                # auto easyocr kserve_v2_ocr nemotron-ocr ocrmac rapidocr tesserocr tesseract
docling options layout             # layout_object_detection docling_layout_default docling_experimental_table_crops_layout
docling options table-structure    # docling_tableformer docling_tableformer_v2 granite_vision_table
docling options ocr rapidocr       # キー：mode・lang・scale・backend・model_size・text_score など
bash例
docling convert scan.pdf --ocr-engine rapidocr --ocr-option backend=torch --ocr-option model_size=tiny --ocr-option text_score=0.6

終了コード#

--fail-on終了コード 1 になる条件
failure（既定）いずれかの文書が失敗
partial失敗または部分的な変換がある
neverなし（常に 0）

既定ではフォルダ変換中にファイルが失敗しても続行します。最初の失敗で止めるには --abort-on-error を付けます。

非推奨・名称変更されたオプション#

古いチュートリアルのコマンドがうまく動かないときは、まずこの表を確認してください。

旧2.148.0 での書き方理由
--force-ocr--ocr-mode full_pageCLI ヘルプで DEPRECATED と表示
--psm N--ocr-option psm=NDEPRECATED。エンジン設定は --ocr-option に移動
--ocr-lang chinese / english（RapidOCR）--ocr-lang ch / en、または iso:zh-Hans旧表記も警告付きで解釈される

リモート変換#

service-client を入れると、CLI に docling convert-remote が加わります。文書を docling-serve サーバーに送り、結果を手元に書き出します。PyTorch は不要で、当サイトの環境では 258 MB でした。

bash
pip install "docling-slim[service-client]"
export DOCLING_SERVICE_URL=http://localhost:5001
export DOCLING_SERVICE_API_KEY=...        # サーバーが要求する場合のみ
docling convert-remote report.pdf --to md --output out/

環境変数#

変数効果
DOCLING_ARTIFACTS_PATH事前ダウンロードしたモデルのフォルダ（--artifacts-path と同じ）
DOCLING_SERVICE_URL・DOCLING_SERVICE_API_KEYconvert-remote のサーバーとキー
OMP_NUM_THREADS内部の数値計算ライブラリのスレッド数を制限

よくある質問

Docling の基本コマンドは？

docling convert file.pdf で PDF を Markdown に変換し、カレントフォルダに保存します。--to json や --to html などで形式を追加し、--output DIR で出力先を指定します。

Docling CLI で OCR を無効にするには？

--no-ocr を付けます。すでにテキストを含む PDF ではこれが正解で、当サイトのベンチマークでは 3.6 倍速くなりました。

フォルダごと変換するには？

フォルダを SOURCE に指定します：docling convert ./inbox --to md --output ./out。--from pdf で PDF だけを対象にし、--abort-on-error で最初の失敗時に停止します。

OCR エンジンのオプションを確認するには？

docling options ocr ENGINE を実行します（例：docling options ocr rapidocr）。--ocr-option KEY=VALUE で渡せるキーが、型と既定値付きで表示されます。

docling convert の終了コードは？

既定ではいずれかの文書が失敗すると 1 で終了します。--fail-on partial は部分変換でも失敗とし、--fail-on never は常に 0 で終了します。

出典

次に読む

設定ビルダー

CLI コマンド・Python・API リクエストを生成

Python API

DocumentConverter・パイプラインオプション・DoclingDocument

OCR

7 つのエンジン・言語・モード、OCR を切る判断

パフォーマンス

ステージ別の実測時間と高速化の方法

トラブルシューティング

実際のエラーメッセージと対処法

コード例

2.148.0 で実行確認したスクリプト