Docling v2.129.0
🇺🇸 English EN 🇩🇪 Deutsch DE 🇯🇵 日本語 JA 🇨🇳 简体中文 ZH 🇫🇷 Français FR 🇪🇸 Español ES
GitHub Commencer
Référence

Recherche de commandes Docling

Les tâches Docling courantes et la commande exacte. Recherchez, filtrez par catégorie et copiez. Les commandes utilisent la syntaxe actuelle docling convert ; vérifiez dans la documentation officielle.

Convertir un PDF en Markdown

BasicStarter

Convertir un PDF local en Markdown structuré.

docling convert report.pdf --to md
Options, sortie et astuces

Options utilisées

  • --to md Format de sortie. RĂ©pĂ©tez l'option pour exporter plusieurs formats Ă  la fois.

Sortie attendue

# Annual Report

## Revenue

| Year | Revenue |
|------|--------:|
| 2025 | $12M |
| 2026 | $15M |

Variantes

Ignorer l'OCR pour un PDF numérique (bien plus rapide)

docling convert report.pdf --to md --no-ocr

Écrire directement dans un dossier

docling convert report.pdf --to md --output ./out

Erreur fréquente : L'exécuter sur un PDF scanné et obtenir un texte vide. Si le PDF n'a pas de couche de texte, ajoutez --ocr-mode full_page.

Convertir un document depuis une URL

BasicStarter

Télécharger et convertir un document en ligne directement depuis une URL HTTP.

docling convert https://arxiv.org/pdf/2408.09869 --to md
Options, sortie et astuces

Options utilisées

  • --to md Format de sortie. RĂ©pĂ©tez l'option pour exporter plusieurs formats Ă  la fois.

Sortie attendue

## Docling Technical Report

The conversion pipeline analyses layout, reading order and tables…

Variantes

Envoyer des en-tĂŞtes de requĂŞte (auth / token)

docling convert https://example.com/report.pdf --headers '{"Authorization":"Bearer TOKEN"}' --to md

Exporter en JSON Ă  la place

docling convert https://arxiv.org/pdf/2408.09869 --to json

Erreur fréquente : Supposer que n'importe quelle URL fonctionne. La source doit être un format de document pris en charge accessible via HTTP(S).

Exporter un JSON sans perte

BasicStarter

Exporter le schéma JSON DoclingDocument, y compris les bounding boxes.

docling convert report.pdf --to json
Options, sortie et astuces

Options utilisées

  • --to json Format de sortie. RĂ©pĂ©tez l'option pour exporter plusieurs formats Ă  la fois.

Sortie attendue

{
  "schema_name": "DoclingDocument",
  "texts": [ ... ],
  "tables": [ ... ],
  "pictures": [ ... ]
}

Variantes

Ignorer l'OCR pour la vitesse

docling convert report.pdf --to json --no-ocr

Intégrer les images en base64

docling convert report.pdf --to json --image-export-mode embedded

Erreur fréquente : Attendre que le JSON CLI et export_to_dict() soient identiques octet pour octet ; ce sont des vues équivalentes du même document.

Vérifier la version installée

BasicStarter

Affiche les versions de Docling, docling-core et docling-ibm-models.

docling --version
Options, sortie et astuces

Options utilisées

  • --version Affiche la version installĂ©e de Docling.

Sortie attendue

Docling version: 2.129.0
Docling Core version: 2.x.x
Docling IBM Models version: 3.x.x
Python: cpython-312 …

Variantes

Mettre à jour vers la dernière version

pip install -U docling docling-core docling-ibm-models

Erreur fréquente : Signaler un bug sans la sortie de version : incluez-la toujours, car les options changent entre les versions.

Lire l'aide intégrée

BasicStarter

Liste toutes les options prises en charge par la version installée de Docling, directement depuis la CLI.

docling convert --help
Options, sortie et astuces

Sortie attendue

Usage: docling convert [OPTIONS] SOURCE

  --from TEXT        Input formats to accept…
  --to TEXT          Output formats…
  --ocr-engine TEXT  The OCR engine to use…

Variantes

Lister les commandes de premier niveau

docling --help

Inspecter le convertisseur distant

docling convert-remote --help

Erreur fréquente : Faire confiance à de vieux articles de blog. Confirmez toujours les options avec --help pour votre version installée.

Enregistrer les résultats dans un dossier

BasicStarter

Écrit les fichiers convertis dans un répertoire de sortie spécifique plutôt que le répertoire courant.

docling convert report.pdf --to md --output ./out
Options, sortie et astuces

Options utilisées

  • --output RĂ©pertoire oĂą les rĂ©sultats sont enregistrĂ©s (pas un nom de fichier).

Sortie attendue

./out/report.md

Variantes

Exporter plusieurs formats Ă  la fois

docling convert report.pdf --to md --to json --to html --output ./out

Erreur fréquente : Oublier que --output prend un répertoire, pas un nom de fichier. Combinez-le avec --to pour choisir l'extension.

Exporter plusieurs formats Ă  la fois

OutputIntermediate

L'option --to est répétable : produisez Markdown, JSON et HTML en une seule exécution.

docling convert report.pdf --to md --to json --to html
Options, sortie et astuces

Options utilisées

  • --to Format de sortie. RĂ©pĂ©tez l'option pour exporter plusieurs formats Ă  la fois.

Sortie attendue

report.md  report.json  report.html

Variantes

Tout dans un seul dossier

docling convert report.pdf --to md --to json --output ./out

Erreur fréquente : Passer une liste séparée par des virgules (--to md,json). Répétez plutôt l'option.

Convertir un dossier entier

BasicIntermediate

Pointez Docling vers un répertoire et il parcourt chaque document pris en charge qu'il contient.

docling convert ./inbox --output ./out
Options, sortie et astuces

Options utilisées

  • --output RĂ©pertoire oĂą les rĂ©sultats sont enregistrĂ©s (pas un nom de fichier).
  • --abort-on-error ArrĂŞte toute l'exĂ©cution dès que le premier fichier Ă©choue.

Sortie attendue

Converting ./inbox/a.pdf … done
Converting ./inbox/b.docx … done

Variantes

Continuer mĂŞme si un fichier Ă©choue

docling convert ./inbox --output ./out --no-abort-on-error

Filtrer sur un seul format

docling convert ./inbox --from pdf --output ./out

Erreur fréquente : Supposer que la récursion dans les sous-dossiers est toujours souhaitable : vérifiez la liste de fichiers affichée avant une grosse exécution.

Convertir plusieurs fichiers nommés

BasicIntermediate

Passez plusieurs chemins dans une seule commande ; chacun est converti indépendamment.

docling convert a.pdf b.docx c.pptx --output ./out
Options, sortie et astuces

Options utilisées

  • source Accepts one or more local paths, directories or URLs.

Sortie attendue

a.md  b.md  c.md  written to ./out

Variantes

Sources mixtes incluant une URL

docling convert a.pdf https://example.com/b.pdf --output ./out

Erreur fréquente : Mettre un glob entre guillemets (“*.pdf”) et attendre que le shell l'étende : laissez le shell l'étendre, ou passez le répertoire.

Pré-télécharger tous les modèles

OfflineIntermediate

Mettre en cache les modèles de mise en page et de tableaux avant un usage hors ligne.

docling-tools models download --all
Options, sortie et astuces

Options utilisées

  • --all Download every available model (large).

Sortie attendue

Downloading layout model…
Downloading tableformer model…
Models cached in $HOME/.cache/docling/models

Variantes

Télécharger uniquement ce dont vous avez besoin

docling-tools models download layout tableformer rapidocr

Télécharger un dépôt HuggingFace

docling-tools models download-hf-repo docling-project/docling-models

Erreur fréquente : Télécharger --all sur une connexion limitée : choisissez les modèles spécifiques que vous utilisez.

Convertir DOCX en Markdown

ConversionStarter

Analyser des documents Microsoft Word en Markdown.

docling convert contract.docx --to md
Options, sortie et astuces

Options utilisées

  • --to md Format de sortie. RĂ©pĂ©tez l'option pour exporter plusieurs formats Ă  la fois.

Sortie attendue

# Service Agreement

1. Scope
2. Payment terms…

Variantes

Fichiers .doc hérités

docling convert contract.doc --to md

Erreur fréquente : Croire que les options OCR comptent : les formats Office sont analysés nativement, donc --ocr-engine est sans effet.

Convertir PPTX en Markdown

ConversionStarter

Analyser les diapositives, zones de texte et notes d'orateur.

docling convert slides.pptx --to md
Options, sortie et astuces

Options utilisées

  • --page-range Convertit uniquement une plage de pages. Pris en charge par PDF, XLSX et PPTX.

Sortie attendue

## Slide 1 — Overview

Bullet one
Bullet two

Variantes

Seulement les dix premières diapositives

docling convert slides.pptx --page-range 1-10 --to md

Erreur fréquente : Supposer que les images des diapositives sont décrites : ajoutez --enrich-picture-description pour cela.

Convertir XLSX en Markdown

ConversionStarter

Analyser les classeurs Excel en tableaux structurés par feuille.

docling convert workbook.xlsx --to md
Options, sortie et astuces

Options utilisées

  • --page-range Convertit uniquement une plage de pages. Pris en charge par PDF, XLSX et PPTX.

Sortie attendue

## Sheet 1

| Region | Q1 | Q2 |
|--------|----|----|
| EMEA   | 12 | 15 |

Variantes

Structure sans perte

docling convert workbook.xlsx --to json

Erreur fréquente : Traiter XLSX comme un PDF et activer l'OCR : les feuilles de calcul n'ont pas de pages bitmap par défaut.

Convertir HTML en Markdown

ConversionStarter

Analyser des pages HTML locales en Markdown.

docling convert page.html --to md
Options, sortie et astuces

Options utilisées

  • --html-image-fetch RĂ©cupère les images rĂ©fĂ©rencĂ©es par les entrĂ©es HTML et EPUB.

Sortie attendue

# Page title

Body text converted from HTML…

Variantes

Télécharger aussi les images distantes

docling convert page.html --html-image-fetch remote --to md

Erreur fréquente : Oublier que la récupération des images est désactivée par défaut ; passez --html-image-fetch si vous avez besoin des images.

Convertir CSV en Markdown

ConversionStarter

Transforme des données séparées par des virgules en tableau Markdown.

docling convert data.csv --to md
Options, sortie et astuces

Options utilisées

  • --to md Format de sortie. RĂ©pĂ©tez l'option pour exporter plusieurs formats Ă  la fois.

Sortie attendue

| name | score |
|------|------:|
| Ada  | 98    |

Variantes

Le conserver en JSON structuré

docling convert data.csv --to json

Erreur fréquente : Utiliser un délimiteur autre que la virgule/le dialecte CSV standard : normalisez-le d'abord.

Convertir EPUB en Markdown

ConversionIntermediate

Convertit les e-books et le contenu EPUB long en conservant la structure des chapitres.

docling convert book.epub --to md
Options, sortie et astuces

Options utilisées

  • --html-image-fetch RĂ©cupère les images rĂ©fĂ©rencĂ©es par les entrĂ©es HTML et EPUB.

Sortie attendue

# Chapter 1

Long-form text…

Variantes

Inclure les illustrations

docling convert book.epub --html-image-fetch all --to md

Erreur fréquente : Ne pas récupérer les images puis se demander pourquoi les figures manquent.

Convertir Markdown en HTML

ConversionIntermediate

Retraite un fichier Markdown et exporte du HTML propre (tableaux et code conservés).

docling convert notes.md --to html
Options, sortie et astuces

Options utilisées

  • --to html Format de sortie. RĂ©pĂ©tez l'option pour exporter plusieurs formats Ă  la fois.

Sortie attendue

<h1>Notes</h1>
<p>…</p>

Variantes

DĂ©couper les pages longues

docling convert notes.md --to html_split_page

Erreur fréquente : Attendre que des fichiers image soient créés : l'export HTML référence des boîtes, il ne rend pas de nouvelles images.

Convertir LaTeX en Markdown

ConversionAdvanced

Analyse les sources LaTeX, avec rendu optionnel des diagrammes TikZ.

docling convert paper.tex --to md
Options, sortie et astuces

Options utilisées

  • --tikz-engine Set to 'tectonic' to rasterize tikzpicture diagrams.

Sortie attendue

# Introduction

The math is preserved as LaTeX where possible…

Variantes

Rendre les diagrammes TikZ en images

docling convert paper.tex --tikz-engine tectonic --to md

Erreur fréquente : Le rendu TikZ retombe silencieusement sur la source lorsque Tectonic est absent ou échoue.

OCR d'une seule image

OCRIntermediate

Convertit une image PNG/JPEG/TIFF contenant du texte en Markdown via OCR.

docling convert scan.png --to md --ocr-mode full_page
Options, sortie et astuces

Options utilisées

  • --ocr-mode full_page Quelles rĂ©gions du document sont transmises au moteur OCR.
  • --ocr-engine Fournisseur du moteur OCR.

Sortie attendue

Text recognised from the image…

Variantes

Utiliser RapidOCR

docling convert scan.png --ocr-engine rapidocr --to md

Erreur fréquente : Utiliser le mode OCR par défaut sur une photo à faible DPI : augmentez la résolution pour une meilleure précision.

OCR d'un PDF scanné

OCRStarter

Forcer l'OCR pleine page sur des pages uniquement image.

docling convert scan.pdf --ocr-mode full_page --to md
Options, sortie et astuces

Options utilisées

  • --ocr-mode full_page Quelles rĂ©gions du document sont transmises au moteur OCR.

Sortie attendue

Text reconstructed from the scanned page images…

Variantes

Choisir le moteur en mĂŞme temps

docling convert scan.pdf --ocr-mode full_page --ocr-engine rapidocr --to md

Erreur fréquente : Laisser l'OCR activé sur les PDF numériques fait perdre du temps. Ne le forcez que si la couche de texte manque ou est incorrecte.

Choisir un moteur OCR

OCRIntermediate

Exécuter l'OCR avec un moteur précis (exemple : RapidOCR).

docling convert scan.pdf --ocr-engine rapidocr --to md
Options, sortie et astuces

Options utilisées

  • --ocr-engine Fournisseur du moteur OCR.

Sortie attendue

Using OCR engine: rapidocr

Variantes

Tesseract avec une langue

docling convert scan.pdf --ocr-engine tesseract --ocr-lang eng --to md

Apple Vision sur macOS

docling convert scan.pdf --ocr-engine ocrmac --to md

Erreur fréquente : Choisir un moteur qui n'est pas installé. RapidOCR est la valeur par défaut multiplateforme la plus sûre.

OCR dans une langue spécifique

OCRIntermediate

Indiquez au moteur OCR quelle(s) langue(s) attendre pour une bien meilleure précision.

docling convert scan.pdf --ocr-engine tesseract --ocr-lang deu,fra --to md
Options, sortie et astuces

Options utilisées

  • --ocr-lang Langues OCR ; utilisez les codes natifs du moteur ou les balises BCP-47 prĂ©fixĂ©es par iso:.

Sortie attendue

Using OCR languages: deu, fra

Variantes

Chinois simplifié via BCP-47

docling convert scan.pdf --ocr-engine rapidocr --ocr-lang iso:zh-Hans --to md

Laisser le moteur détecter automatiquement

docling convert scan.pdf --ocr-lang '' --to md

Erreur fréquente : Mélanger les conventions des moteurs. Chaque moteur a ses propres codes : préfixez les balises BCP-47 canoniques par iso:.

Désactiver l'OCR (PDF numériques)

OCRStarter

Ignorer l'OCR pour les PDF disposant déjà d'une couche de texte.

docling convert report.pdf --no-ocr --to md
Options, sortie et astuces

Options utilisées

  • --no-ocr Turn OCR off; the embedded text layer is used as-is.

Sortie attendue

Skipping OCR (digital text layer detected)…

Variantes

Ignorer aussi les tableaux dont vous n'avez pas besoin

docling convert report.pdf --no-ocr --no-tables --to md

Erreur fréquente : Utiliser --no-ocr sur un scan : vous obtiendrez une sortie vide ou presque vide.

OCR uniquement sur les régions de mise en page

OCRAdvanced

Exécute l'OCR uniquement sur les régions détectées au lieu de la page entière.

docling convert report.pdf --ocr-mode layout_regions --to md
Options, sortie et astuces

Options utilisées

  • --ocr-mode layout_regions Quelles rĂ©gions du document sont transmises au moteur OCR.

Sortie attendue

OCR applied to detected layout regions…

Variantes

Sélection de région tenant compte du PDF

docling convert report.pdf --ocr-mode pdf_aware_layout_regions --to md

Erreur fréquente : Utiliser les modes de région alors que toute la page est une photo : utilisez full_page dans ce cas.

DĂ©finir le mode de segmentation de page Tesseract

OCRAdvanced

Affinez l'analyse de mise en page Tesseract avec un mode de segmentation de page (0-13).

docling convert scan.pdf --ocr-engine tesseract --psm 6 --to md
Options, sortie et astuces

Options utilisées

  • --psm Page Segmentation Mode pour les moteurs Tesseract.

Sortie attendue

Tesseract PSM 6 — assume a single uniform block of text.

Variantes

Une seule ligne de texte

docling convert scan.pdf --ocr-engine tesseract --psm 7 --to md

Erreur fréquente : Définir PSM sur des moteurs non-Tesseract où il est ignoré.

Extraction de tableaux plus rapide

TablesIntermediate

Utiliser le mode tableau rapide au lieu du modèle précis.

docling convert report.pdf --table-mode fast --to md
Options, sortie et astuces

Options utilisées

  • --table-mode Compromis prĂ©cision/vitesse pour le modèle de structure de tableau.

Sortie attendue

Rough table grid, produced faster…

Variantes

Ignorer complètement les tableaux

docling convert report.pdf --no-tables --to md

Erreur fréquente : Utiliser fast sur des feuilles financières avec cellules fusionnées : la précision chute nettement.

DĂ©sactiver l'extraction de tableaux

TablesIntermediate

Ignorez le modèle de structure de tableau lorsque vous n'avez besoin que de texte.

docling convert report.pdf --no-tables --to md
Options, sortie et astuces

Options utilisées

  • --no-tables Do not run the table structure model.

Sortie attendue

Tables rendered as plain text flow…

Variantes

Chemin de texte numérique le plus rapide

docling convert report.pdf --no-ocr --no-tables --to md

Erreur fréquente : L'activer alors que les tableaux comptent : le contenu du tableau se fondra dans les paragraphes.

Utiliser le moteur TableFormer v2

TablesAdvanced

Sélectionnez un moteur de structure de tableau spécifique, y compris le nouveau TableFormer v2.

docling convert report.pdf --table-structure-engine docling_tableformer_v2 --to md
Options, sortie et astuces

Options utilisées

  • --table-structure-engine SĂ©lectionne le moteur de structure de tableau.

Sortie attendue

Using table structure engine: docling_tableformer_v2

Variantes

Moteur de tableaux Granite vision

docling convert report.pdf --table-structure-engine granite_vision_table --to md

Erreur fréquente : Supposer que chaque moteur est inclus : certains nécessitent des téléchargements de modèles ou plugins supplémentaires.

Activer l'enrichissement code et formules

EnrichmentIntermediate

Extraire les formules LaTeX et les blocs de code avec des modèles d'enrichissement.

docling convert paper.pdf --enrich-code --enrich-formula --to md
Options, sortie et astuces

Options utilisées

  • --enrich-code DĂ©tecte et Ă©tiquette les blocs de code.
  • --enrich-formula Extrait les formules au format LaTeX.

Sortie attendue

```python
def hello(): …
```

$$ E = mc^2 $$

Variantes

Formules uniquement

docling convert paper.pdf --enrich-formula --to md

Code uniquement

docling convert repo.pdf --enrich-code --to md

Erreur fréquente : Activer les deux sur des documents sans code ni mathématiques : chacun ajoute une passe neuronale et ralentit la conversion.

DĂ©crire les images avec un VLM

EnrichmentAdvanced

Génère des descriptions en langage naturel pour les figures et images.

docling convert report.pdf --enrich-picture-description --to md
Options, sortie et astuces

Options utilisées

  • --enrich-picture-description GĂ©nère des descriptions d'images avec un modèle de vision.

Sortie attendue

<!-- picture: a bar chart showing revenue growth from 2020 to 2026 -->

Variantes

Limiter les tokens générés

docling convert report.pdf --enrich-picture-description --picture-description-max-new-tokens 256 --to md

Erreur fréquente : L'exécuter sur des documents riches en images sans assez de RAM/VRAM : il charge un modèle de vision.

Classer les images

EnrichmentAdvanced

Étiquette les images par classe (graphique, schéma, capture, photo…) avec un modèle classificateur.

docling convert report.pdf --enrich-picture-classes --to md
Options, sortie et astuces

Options utilisées

  • --enrich-picture-classes Classe les images (graphique, schĂ©ma, capture…).

Sortie attendue

<!-- picture class: chart -->

Variantes

Classer et décrire

docling convert report.pdf --enrich-picture-classes --enrich-picture-description --to md

Erreur fréquente : Attendre des étiquettes parfaites : c'est un classificateur léger, pas un modèle de vision complet.

Extraire les données de graphiques vers des tableaux

EnrichmentAdvanced

Transforme les graphiques à barres, circulaires et linéaires en données tabulaires avec le modèle d'extraction de graphiques.

docling convert report.pdf --enrich-chart-extraction --to md
Options, sortie et astuces

Options utilisées

  • --enrich-chart-extraction Extrait les donnĂ©es des graphiques Ă  barres, circulaires et linĂ©aires.

Sortie attendue

<!-- chart: category | value -->
<!-- 2025 | 12 -->

Variantes

Combiner avec la sortie de tableaux

docling convert report.pdf --enrich-chart-extraction --to json

Erreur fréquente : Attendre que des scans de graphiques 3D complexes soient extraits : les graphiques au-delà de barres/circulaires/lignes sont hors périmètre.

Exporter des chunks pour le RAG

RAGIntermediate

Produire des chunks HybridChunker qui préservent la structure.

docling convert report.pdf --to chunks --chunks-type hybrid
Options, sortie et astuces

Options utilisées

  • --to chunks Format de sortie. RĂ©pĂ©tez l'option pour exporter plusieurs formats Ă  la fois.
  • --chunks-type Type de chunker utilisĂ© avec --to chunks.

Sortie attendue

{ "text": "…", "meta": { "headings": ["Revenue"] } }

Variantes

Limiter la taille des chunks

docling convert report.pdf --to chunks --chunks-max-tokens 512

Chunks hiérarchiques

docling convert report.pdf --to chunks --chunks-type hierarchical

Erreur fréquente : Découper l'export Markdown avec un découpeur naïf au lieu d'utiliser le chunker conscient de la structure de Docling.

DĂ©finir la taille des chunks

RAGAdvanced

Contrôle le nombre maximal de tokens par chunk et le tokenizer utilisé pour le chunking hybride.

docling convert report.pdf --to chunks --chunks-max-tokens 512
Options, sortie et astuces

Options utilisées

  • --chunks-max-tokens Nombre maximal de tokens par chunk.
  • --chunks-tokenizer Tokenizer utilisĂ© pour le chunking hybride.

Sortie attendue

Chunks sized to the embedding model's token limit…

Variantes

Aligner sur un autre modèle d'embedding

docling convert report.pdf --to chunks --chunks-tokenizer BAAI/bge-small-en-v1.5

Erreur fréquente : Définir une taille de chunk supérieure à celle que prend en charge votre modèle d'embedding : elle sera tronquée.

Convertir avec un pipeline VLM

VLMAdvanced

Utiliser le pipeline VLM avec le modèle Granite Docling.

docling convert report.pdf --pipeline vlm --vlm-model granite_docling --to md
Options, sortie et astuces

Options utilisées

  • --pipeline vlm Pipeline de traitement pour les fichiers PDF et image.
  • --vlm-model PrĂ©rĂ©glage VLM utilisĂ© avec --pipeline vlm.

Sortie attendue

Markdown generated page-by-page by the vision model…

Variantes

Préréglage SmolDocling plus petit

docling convert report.pdf --pipeline vlm --vlm-model smoldocling --to md

Conserver la sortie brute du modèle

docling convert report.pdf --pipeline vlm --vlm-write-native-output

Erreur fréquente : Supposer que le VLM est toujours meilleur : pour les PDF numériques simples, le pipeline standard est plus rapide et moins coûteux.

Limiter la longueur de génération du VLM

VLMAdvanced

Remplace le nombre maximal de tokens que le VLM peut générer par page.

docling convert report.pdf --pipeline vlm --vlm-max-new-tokens 8192 --to md
Options, sortie et astuces

Options utilisées

  • --vlm-max-new-tokens Remplace max_new_tokens pour la gĂ©nĂ©ration VLM.

Sortie attendue

Long, dense pages no longer get cut off…

Variantes

Conserver la sortie brute pour le débogage

docling convert report.pdf --pipeline vlm --vlm-write-native-output

Erreur fréquente : Laisser la valeur par défaut sur des pages très denses peut tronquer la sortie de la page.

Transcrire audio ou vidéo (ASR)

AudioIntermediate

Transcrire WAV/MP3 (et vidéo) avec le pipeline ASR.

docling convert lecture.mp3 --pipeline asr --to md
Options, sortie et astuces

Options utilisées

  • --pipeline asr Pipeline de traitement pour les fichiers PDF et image.
  • --asr-model Modèle ASR pour les fichiers audio et vidĂ©o.

Sortie attendue

00:00:00 — Welcome to the show…

Variantes

Meilleure précision

docling convert lecture.mp3 --pipeline asr --asr-model whisper_medium --to md

Sortie sous-titres

docling convert lecture.mp3 --pipeline asr --to vtt

Erreur fréquente : Utiliser le whisper_tiny par défaut pour une transcription importante ; choisissez medium/large pour la précision.

Transcrire une vidéo en sous-titres

AudioIntermediate

Transcrit l'audio d'une vidéo et exporte des sous-titres WebVTT horodatés.

docling convert talk.mp4 --pipeline asr --to vtt
Options, sortie et astuces

Options utilisées

  • --to vtt Format de sortie. RĂ©pĂ©tez l'option pour exporter plusieurs formats Ă  la fois.

Sortie attendue

WEBVTT

00:00:00.000 --> 00:00:04.000
Hello and welcome…

Variantes

Un autre modèle ASR

docling convert talk.mp4 --pipeline asr --asr-model whisper_small --to vtt

Erreur fréquente : Attendre que les options OCR/tableaux s'appliquent : la vidéo n'utilise que le pipeline ASR.

Échantillonner la vidéo par changements de scène

AudioAdvanced

Choisissez comment les images sont échantillonnées : intervalle fixe ou changements de scène.

docling convert talk.mp4 --pipeline asr --video-sampling-mode scene
Options, sortie et astuces

Options utilisées

  • --video-sampling-mode Comment les images vidĂ©o sont Ă©chantillonnĂ©es.
  • --video-frame-interval Secondes entre les images en mode intervalle fixe.

Sortie attendue

Frames sampled at scene changes…

Variantes

Échantillonnage fixe plus dense

docling convert talk.mp4 --pipeline asr --video-frame-interval 5

Erreur fréquente : Utiliser le mode scène sur une caméra statique unique : l'intervalle fixe y est plus prévisible.

Diarisation des locuteurs (qui a dit quoi)

AudioAdvanced

Étiquette les locuteurs dans les transcriptions audio/vidéo (nécessite l'extra resemblyzer).

docling convert interview.mp4 --pipeline asr --video-diarization
Options, sortie et astuces

Options utilisées

  • --video-diarization Active la sĂ©paration des locuteurs (nĂ©cessite resemblyzer).

Sortie attendue

[SPEAKER_00] …
[SPEAKER_01] …

Variantes

DĂ©sactiver explicitement la diarisation

docling convert interview.mp4 --pipeline asr --no-video-diarization

Erreur fréquente : Oublier que la diarisation nécessite la dépendance resemblyzer installée.

Exporter les images en fichiers PNG

OutputIntermediate

Écrit les figures dans des fichiers PNG séparés et les référence depuis le document de sortie.

docling convert report.pdf --to md --image-export-mode referenced --output ./out
Options, sortie et astuces

Options utilisées

  • --image-export-mode Comment les images sont exportĂ©es pour les sorties JSON, YAML, HTML et Markdown.

Sortie attendue

./out/report.md + ./out/report_artifacts/*.png

Variantes

Marquer seulement les positions des images

docling convert report.pdf --to md --image-export-mode placeholder

Intégrer en base64

docling convert report.pdf --to json --image-export-mode embedded

Erreur fréquente : Utiliser referenced avec --to json et attendre les PNG à côté : vérifiez le dossier des artefacts.

Exporter DocTags

OutputAdvanced

Produit le balisage DocTags compact de style token utilisé comme entrée de modèle.

docling convert report.pdf --to doctags
Options, sortie et astuces

Options utilisées

  • --to doctags Format de sortie. RĂ©pĂ©tez l'option pour exporter plusieurs formats Ă  la fois.

Sortie attendue

<doctag><page_1><section_header_level_1>Annual Report</section_header_level_1>…

Variantes

Avec sortie native VLM

docling convert report.pdf --pipeline vlm --to doctags

Erreur fréquente : Traiter DocTags comme du Markdown : c'est une représentation interne compacte pour les modèles.

Exporter du HTML paginé

OutputAdvanced

Produit du HTML fractionné par page : pratique pour les visionneuses et la revue côte à côte.

docling convert report.pdf --to html_split_page --output ./out
Options, sortie et astuces

Options utilisées

  • --to html_split_page Format de sortie. RĂ©pĂ©tez l'option pour exporter plusieurs formats Ă  la fois.

Sortie attendue

./out/report_1.html  report_2.html …

Variantes

HTML en un seul fichier

docling convert report.pdf --to html

Erreur fréquente : Chercher un seul fichier HTML alors que la sortie fractionnée en écrit un par page.

Visualiser la mise en page détectée

OutputAdvanced

Superpose les cadres englobants détectés sur les images de page dans la sortie.

docling convert report.pdf --show-layout --to md --output ./out
Options, sortie et astuces

Options utilisées

  • --show-layout Superpose les cadres englobants des Ă©lĂ©ments sur les images de page.

Sortie attendue

Page images with coloured layout boxes…

Variantes

Visualiser les cellules de tableau

docling convert report.pdf --debug-visualize-tables

Erreur fréquente : Attendre que les boîtes soient dessinées sur le Markdown lui-même : elles le sont sur les images de page exportées.

Exécuter sur un GPU NVIDIA (CUDA)

PerformanceIntermediate

Accélère l'inférence avec CUDA et ajuste les réglages de threads/lots.

docling convert report.pdf --device cuda --num-threads 8 --to md
Options, sortie et astuces

Options utilisées

  • --device cuda AccĂ©lĂ©rateur matĂ©riel pour l'infĂ©rence du modèle.
  • --num-threads Threads utilisĂ©s pour l'infĂ©rence du modèle.

Sortie attendue

Using accelerator device: cuda

Variantes

Lots de pages plus grands

docling convert big.pdf --device cuda --page-batch-size 16

Erreur fréquente : Passer --device cuda sur une machine sans runtime CUDA ; utilisez plutôt auto ou cpu.

Exécuter sur Apple Silicon (MPS)

PerformanceIntermediate

Utilise le backend Metal sur les Mac série M pour une inférence accélérée.

docling convert report.pdf --device mps --to md
Options, sortie et astuces

Options utilisées

  • --device mps AccĂ©lĂ©rateur matĂ©riel pour l'infĂ©rence du modèle.

Sortie attendue

Using accelerator device: mps

Variantes

Laisser Docling choisir

docling convert report.pdf --device auto --to md

Erreur fréquente : Attendre que MPS égale un GPU dédié : c'est une bonne accélération, pas une carte de centre de données.

Augmenter la taille de lot de pages

PerformanceAdvanced

Traite plus de pages par lot pour augmenter le débit GPU/CPU sur les gros documents.

docling convert big.pdf --page-batch-size 16 --to md
Options, sortie et astuces

Options utilisées

  • --page-batch-size Pages traitĂ©es en un lot.

Sortie attendue

Processing 16 pages per batch…

Variantes

Revenir en arrière en cas de manque de mémoire

docling convert big.pdf --page-batch-size 2

Erreur fréquente : L'augmenter jusqu'à provoquer une erreur de mémoire insuffisante : réduisez-le si la conversion plante.

Définir un délai par document

PerformanceAdvanced

Protège un lot d'un seul fichier problématique en limitant le temps de traitement.

docling convert ./inbox --document-timeout 120 --output ./out
Options, sortie et astuces

Options utilisées

  • --document-timeout DĂ©lai de traitement pour chaque document.

Sortie attendue

Timed out after 120s — moving to the next file…

Variantes

Abandonner tout le lot en cas d'Ă©chec

docling convert ./inbox --abort-on-error --output ./out

Erreur fréquente : Définir un délai très court sur d'énormes documents et obtenir de faux échecs.

Profiler le pipeline de conversion

PerformanceAdvanced

Résume où le temps est passé dans les étapes de conversion pour trouver les goulots d'étranglement.

docling convert report.pdf --profiling --to md
Options, sortie et astuces

Options utilisées

  • --profiling RĂ©sume le temps passĂ© Ă  chaque Ă©tape de conversion.
  • --save-profiling Save profiling summaries to JSON.

Sortie attendue

layout: 3.2s  ocr: 1.1s  tableformer: 0.9s  total: 5.4s

Variantes

Enregistrer les chiffres en JSON

docling convert report.pdf --profiling --save-profiling

Erreur fréquente : Profiler avec -v activé et confondre le temps de journalisation avec le temps du modèle.

Convertir seulement une plage de pages

ConversionIntermediate

Analyse un sous-ensemble de pages au lieu de tout le document.

docling convert report.pdf --page-range 1-4 --to md
Options, sortie et astuces

Options utilisées

  • --page-range Convertit uniquement une plage de pages. Pris en charge par PDF, XLSX et PPTX.

Sortie attendue

Converting pages 1-4 only…

Variantes

Une seule page

docling convert report.pdf --page-range 3 --to md

Erreur fréquente : Attendre que tous les backends respectent la plage : principalement PDF, XLSX et PPTX.

Ouvrir un PDF protégé par mot de passe

ConversionAdvanced

Fournissez un mot de passe pour convertir les PDF chiffrés.

docling convert locked.pdf --pdf-password 'secret' --to md
Options, sortie et astuces

Options utilisées

  • --pdf-password Mot de passe pour les documents PDF protĂ©gĂ©s.

Sortie attendue

Decrypting and converting locked.pdf…

Variantes

Utiliser un mot de passe depuis une variable d'environnement

docling convert locked.pdf --pdf-password "$PDF_PW" --to md

Erreur fréquente : Mettre un vrai mot de passe dans l'historique du shell ; préférez une variable d'environnement.

Changer le backend PDF

ConversionAdvanced

Choisissez entre le backend par défaut docling-parse et pypdfium2 pour les PDF problématiques.

docling convert report.pdf --pdf-backend pypdfium2 --to md
Options, sortie et astuces

Options utilisées

  • --pdf-backend docling_parse (default) or pypdfium2.

Sortie attendue

Using PDF backend: pypdfium2

Variantes

Parseur par défaut

docling convert report.pdf --pdf-backend docling_parse --to md

Erreur fréquente : Rester sur la valeur par défaut pour les PDF aux encodages de police cassés : essayez pypdfium2.

Utiliser un chemin de modèles personnalisé

OfflineAdvanced

Pointez Docling vers un répertoire de modèles prérempli au lieu du cache par défaut.

docling convert report.pdf --artifacts-path /opt/docling/models --to md
Options, sortie et astuces

Options utilisées

  • --artifacts-path Emplacement des artefacts de modèle prĂ©tĂ©lĂ©chargĂ©s.

Sortie attendue

Loading models from /opt/docling/models…

Variantes

Utiliser plutĂ´t une variable d'environnement

DOCLING_ARTIFACTS_PATH=/opt/docling/models docling convert report.pdf --to md

Erreur fréquente : Pointer vers un répertoire vide : Docling tente alors de télécharger et peut échouer hors ligne.

Exécuter entièrement hors ligne (air-gapped)

OfflineAdvanced

Prétéléchargez les modèles sur un hôte connecté, puis convertissez sans accès réseau.

export HF_HUB_OFFLINE=1; export DOCLING_ARTIFACTS_PATH=/opt/docling/models; docling convert report.pdf --to md
Options, sortie et astuces

Options utilisées

  • DOCLING_ARTIFACTS_PATH Directory holding the pre-downloaded models.
  • HF_HUB_OFFLINE Stop HuggingFace downloads and use the local cache only.

Sortie attendue

Conversion completes with no outbound requests…

Variantes

Choisir le répertoire de cache HF

export HF_HOME=/opt/docling/hf; docling convert report.pdf --to md

Erreur fréquente : Oublier HF_HUB_OFFLINE=1, ce qui fait que Docling tente une récupération réseau et se bloque ou échoue.

Exécuter l'API Docling Serve

ServerIntermediate

DĂ©marrer l'API HTTP docling-serve et l'UI sur le port 5001.

docling-serve run --enable-ui
Options, sortie et astuces

Options utilisées

  • --enable-ui Serve the built-in web UI alongside the API.

Sortie attendue

Uvicorn running on http://0.0.0.0:5001  (docs at /docs)

Variantes

Exécuter dans Docker

docker run -p 5001:5001 -e DOCLING_SERVE_ENABLE_UI=1 quay.io/docling-project/docling-serve

Erreur fréquente : Exposer le service publiquement sans authentification : placez un proxy et une auth devant.

Convertir via un service distant

ServerAdvanced

Décharge la conversion vers une instance docling-serve en cours d'exécution (fichiers, dossiers ou URL locaux).

docling convert-remote report.pdf --service-url http://localhost:5001 --to md
Options, sortie et astuces

Options utilisées

  • --service-url Base URL of docling-serve (or DOCLING_SERVICE_URL).
  • --api-key Optional API key (or DOCLING_SERVICE_API_KEY).

Sortie attendue

submitting job… polling… report.md written

Variantes

Service authentifié

docling convert-remote report.pdf --service-url https://docling.internal --api-key "$DOCLING_KEY" --to md

Utiliser le polling au lieu du websocket

docling convert-remote report.pdf --service-url http://localhost:5001 --watcher polling --to md

Erreur fréquente : Passer des options purement locales comme --device à convert-remote ; elles sont volontairement absentes.

Exécuter le serveur MCP

MCPIntermediate

Lancer le serveur Model Context Protocol pour les clients IA de bureau.

uvx --from=docling-mcp docling-mcp-server
Options, sortie et astuces

Options utilisées

  • --from=docling-mcp Restreint les formats d'entrĂ©e acceptĂ©s. Utilisez 'odf' pour odt, ods et odp.

Sortie attendue

docling-mcp server ready (stdio)

Variantes

Configuration JSON pour un client IA

{"mcpServers": {"docling": {"command": "uvx", "args": ["--from=docling-mcp", "docling-mcp-server"]}}}

Erreur fréquente : Coller la commande au lieu du bloc JSON dans la configuration MCP du client.

Augmenter la verbosité des journaux

DebugIntermediate

Affiche la progression (-v) ou la journalisation de débogage complète (-vv) pour diagnostiquer une conversion.

docling convert report.pdf -vv --to md
Options, sortie et astuces

Options utilisées

  • -v / --verbose Repeat for more detail: -v info, -vv debug.
  • -q / --quiet Silence per-file progress (warnings and errors remain).

Sortie attendue

DEBUG docling.pipeline… loading layout model

Variantes

Lot silencieux pour les scripts

docling convert ./inbox --quiet --output ./out

Erreur fréquente : Laisser -vv activé en production : la journalisation de débogage est lente et très bruyante.

Visualiser les cellules, l'OCR et les tableaux

DebugAdvanced

Les visualiseurs de débogage affichent ce que chaque étape a détecté, pour le réglage et le dépannage.

docling convert report.pdf --debug-visualize-tables
Options, sortie et astuces

Options utilisées

  • --debug-visualize-layout Visualise les clusters de mise en page.
  • --debug-visualize-tables Visualise les cellules de tableau.
  • --debug-visualize-ocr Visualise les cellules OCR.
  • --debug-visualize-cells Visualise PDF cells.

Sortie attendue

Annotated page images written next to the output…

Variantes

Inspecter la détection OCR

docling convert scan.pdf --debug-visualize-ocr

Inspecter les clusters de mise en page

docling convert report.pdf --debug-visualize-layout

Erreur fréquente : Utiliser plusieurs visualiseurs à la fois et obtenir un nombre écrasant d'images.

Besoin d'autre chose ? Créez une commande personnalisée ou consultez la référence pratique.

Commencez ici

Choisissez votre scénario

Le chemin le plus rapide d'un type de document Ă  une commande qui fonctionne. Copiez-en une et changez le nom du fichier.

PDF scanné, sans couche de texte

L'OCR pleine page récupère le contenu.

docling convert scan.pdf --ocr-mode full_page --to md

PDF numérique, résultat le plus rapide

Ignorez l'OCR et les tableaux inutiles.

docling convert report.pdf --no-ocr --to md

Article de recherche avec mathématiques

Extrayez les formules LaTeX et les blocs de code.

docling convert paper.pdf --enrich-formula --enrich-code --to md

Rapport financier avec tableaux

Conservez des tableaux précis et une structure sans perte.

docling convert report.pdf --table-mode accurate --to json

Alimenter un pipeline RAG

Des chunks conscients de la structure, prêts à être vectorisés.

docling convert report.pdf --to chunks --chunks-type hybrid

Scan multilingue

Indiquez Ă  l'OCR quelles langues attendre.

docling convert scan.pdf --ocr-engine tesseract --ocr-lang deu,fra --to md

Transcrire une réunion

De la parole au texte avec un modèle Whisper plus grand.

docling convert meeting.mp3 --pipeline asr --asr-model whisper_medium --to md

Mise en page visuelle complexe

Laissez un modèle vision-langage lire la page.

docling convert brochure.pdf --pipeline vlm --vlm-model granite_docling --to md

Exécution hors ligne / air-gapped

Utilisez des modèles prétéléchargés sans réseau.

HF_HUB_OFFLINE=1 docling convert report.pdf --artifacts-path /opt/models --to md
1
Commencez ici

Comment fonctionne la CLI

Dans Docling v2, la conversion réside dans la sous-commande explicite convert. Toutes les commandes ont la même forme :

  • source peut ĂŞtre un fichier local, un rĂ©pertoire ou une URL HTTP(S).
  • Les sorties sont Ă©crites Ă  cĂ´tĂ© par dĂ©faut — choisissez un dossier avec --output et un format avec --to.
  • L'aide fait autoritĂ©. docling convert --help liste toujours exactement ce que votre version installĂ©e prend en charge.
docling convert <source> [options]
docling convert report.pdf --to md --output ./out
!La plupart des anciens tutoriels écrivent docling report.pdf — c'est la syntaxe v1 et cela ne fonctionne plus aujourd'hui. Voir Migrer depuis la v1.
iCommandes compagnons : docling-tools models prétélécharge les modèles, docling convert-remote dialogue avec un service en cours d'exécution, et docling-serve expose une API HTTP.
2
Pipeline

Choisir un pipeline

Le pipeline est le plus grand choix structurel : il détermine quels modèles s'exécutent sur votre PDF ou image.

docling convert report.pdf --pipeline vlm --vlm-model granite_docling --to md
PipelineQuand l'utiliserCompromis
standardPar défaut pour PDF et images — mise en page, OCR, tableaux.Équilibré et bien maîtrisé.
nativeVous voulez l'analyseur natif threadé pour les gros PDF.Analyse rapide ; réglez avec --parser-threads.
vlmMises en page complexes et visuellement riches qu'un seul modèle gère mieux.Charge un modèle de vision ; plus lent et plus lourd.
asrFichiers audio et vidéo (famille Whisper).Parole uniquement ; les options OCR/tableaux ne s'appliquent pas.
legacyReproduire l'ancien comportement.Non recommandé pour les nouveaux travaux.
iPour les PDF numériques ordinaires, le pipeline standard est plus rapide et moins coûteux qu'un VLM — commencez par celui-ci.
3
Formats

Entrées et sorties

Docling lit le PDF, la famille Office, HTML, EPUB, CSV, les images, l'audio/vidéo et plus encore. Consultez la référence des formats pris en charge pour la liste complète et les notes par format.

L'option --to est répétable, donc une exécution peut produire plusieurs formats. Sorties courantes :

docling convert report.pdf --to md --to json --to chunks --output ./out
FormatCe que vous obtenezIdéal pour
mdMarkdown lisible avec tableauxNotes, docs, texte pour RAG (par défaut)
jsonDoclingDocument sans perte avec cadres englobantsPipelines personnalisés et structure
chunksChunks conscients de la structureEmbeddings et bases vectorielles
htmlUn seul fichier HTMLAperçus web et e-mail
html_split_pageUn fichier HTML par pageVisionneuses page par page
doctagsBalisage compact de type tokenEntrée de modèle et flux de tokens
yaml, text, vtt, doclang, dclx, latexFormats sérialisés, de sous-titres, d'archive et de sourceOutils en aval spécifiques
iContrĂ´lez la gestion des images avec --image-export-mode placeholder|embedded|referenced.
4
OCR

DĂ©cider de l'OCR

L'OCR est le plus grand facteur unique tant pour la précision que pour le temps d'exécution. Activez-le délibérément.

  • Activez l'OCR pour les scans, photos et PDF sans couche de texte.
  • DĂ©sactivez l'OCR pour les PDF numĂ©riques (--no-ocr) — souvent plusieurs fois plus rapide.
  • Le mode default n'applique l'OCR qu'aux pages sans texte ; full_page applique l'OCR Ă  chaque page et Ă©crase le texte dĂ©tectĂ©.
  • layout_regions et pdf_aware_layout_regions n'appliquent l'OCR qu'aux rĂ©gions dĂ©tectĂ©es.
docling convert scan.pdf --ocr-mode full_page --to md
!Sortie vide d'un PDF scanné ? Forcez --ocr-mode full_page. L'OCR ne s'exécutera pas sur du texte programmatique même si la police est cassée.

Choisissez un moteur avec --ocr-engine et donnez-lui une langue avec --ocr-lang. Comparez les moteurs dans la référence OCR.

5
Performance

Vitesse et matériel

Le coût de conversion est dominé par les modèles exécutés et l'endroit où ils s'exécutent.

docling convert report.pdf --device cuda --num-threads 8 --to md
LevierEffet
--no-ocrLe plus grand gain sur les PDF numériques.
--no-tables, ignorer l'enrichissementÉvite des passes neuronales inutiles.
--device cuda|mps|xpuDéplace l'inférence vers un GPU (CUDA, Apple Silicon, Intel).
--num-threadsParallélisme CPU pour l'inférence (par défaut 4).
--page-batch-sizePlus de pages par lot — augmentez jusqu'à saturation mémoire.
--profilingMontre le temps par Ă©tape pour optimiser le vrai goulot d'Ă©tranglement.
iProtégez les longs lots avec --document-timeout 120. Pour les accélérateurs air-gapped, voir --artifacts-path.
6
Automatisation

Traitement par lots et automatisation

Passez un répertoire et Docling le parcourt pour vous, ou bouclez dans votre shell pour un contrôle total des noms, du parallélisme et des exécutions incrémentales.

Conversion de dossier intégrée

Docling parcourt un répertoire pour vous — la voie par lots la plus simple.

docling convert ./inbox --output ./out
Boucle de dossier PowerShell

Contrôle total sur les fichiers récupérés sous Windows.

Get-ChildItem ./inbox -Recurse -Filter *.pdf | ForEach-Object { docling convert $_.FullName --to md --output ./out }
Lot parallèle avec xargs

Quatre conversions Ă  la fois pour un gros rattrapage (attention CPU/RAM).

find ./inbox -name '*.pdf' -print0 \ | xargs -0 -P 4 -I{} docling convert {} --to md --output ./out
Convertir uniquement les nouveaux fichiers

Ignore les fichiers ayant déjà une sortie ; utile pour les exécutions incrémentales.

for f in ./inbox/*.pdf; do out="./out/$(basename "${f%.pdf}").md" [ -f "$out" ] || docling convert "$f" --to md --output ./out done
Lot de production robuste

Délai par document et poursuite après les échecs.

docling convert ./inbox --output ./out \ --document-timeout 120 \ --no-abort-on-error \ --quiet
Un format, en flux

Dirige un seul document directement vers un fichier sous Windows.

docling convert .\report.pdf --to md | Out-File -Encoding utf8 .\report.md
!Les exécutions parallèles partagent un pipeline de modèle par processus — surveillez CPU et RAM, et réduisez -P ou --page-batch-size si la machine swappe.
7
RAG

Chunks pour le RAG

Docling découpe l'arbre du document, pas une chaîne plate, donc les titres et les tableaux survivent dans les chunks.

  • --chunks-type hybrid (par dĂ©faut) ou hierarchical.
  • --chunks-max-tokens correspond Ă  la limite de votre modèle d'embedding.
  • --chunks-tokenizer choisit le tokenizer HuggingFace utilisĂ© pour compter les tokens.
docling convert report.pdf --to chunks --chunks-type hybrid --chunks-max-tokens 512

Voir le guide RAG pour des exemples de bases vectorielles.

8
Hors ligne

Hors ligne et modèles

Prétéléchargez les modèles une fois sur un hôte connecté, puis convertissez sans réseau sur l'hôte isolé.

  • docling-tools models download layout tableformer rapidocr ne rĂ©cupère que ce que vous utilisez.
  • DĂ©finissez DOCLING_ARTIFACTS_PATH au lieu de l'option pour les scripts.
  • RapidOCR peut peiner sur les systèmes de fichiers en lecture seule — prĂ©fĂ©rez Tesseract dans ces environnements.
docling-tools models download --all
HF_HUB_OFFLINE=1 docling convert report.pdf --artifacts-path /opt/docling/models --to md
9
Serveur

Serveur et conversions distantes

Exécutez la conversion en tant que service lorsque de nombreux clients ou langues en ont besoin, puis déchargez-la avec le client distant.

docling-serve run --enable-ui
docling convert-remote report.pdf --service-url http://localhost:5001 --to md
iconvert-remote omet volontairement les options purement locales comme --device — le serveur maîtrise l'exécution. Pour les clients IA, voir le guide du serveur MCP.
10
DĂ©bogage

DĂ©boguer une conversion

Lorsque la sortie semble incorrecte, augmentez d'abord la journalisation, puis visualisez ce que chaque étape a détecté.

  • -v journalisation d'information, -vv journalisation de dĂ©bogage complète, -q silencieux pour les scripts.
  • --debug-visualize-layout, --debug-visualize-tables, --debug-visualize-ocr affichent ce que chaque Ă©tape a trouvĂ©.
  • --show-layout superpose les cadres englobants sur les images de page exportĂ©es.
  • --pdf-backend pypdfium2 aide avec les PDF utilisant des encodages de police cassĂ©s.
docling convert report.pdf -vv --to md
11
Migration

Migrer depuis la syntaxe v1

Docling v2 a réorganisé la surface des commandes. Si un tutoriel, un script ou un job CI utilise l'ancienne forme, mappez-le avec ce tableau.

Ancienne syntaxeSyntaxe actuellePourquoi
docling report.pdfdocling convert report.pdf --to mdv1 convertissait directement ; la v2 a déplacé la conversion sous la sous-commande convert.
docling report.pdf --format jsondocling convert report.pdf --to json--format est devenu --to.
docling report.pdf -o out.mddocling convert report.pdf --to md --output ./out-o/--output est désormais un répertoire, pas un fichier de destination.
--force-ocr--ocr-mode full_page--force-ocr est obsolète ; utilisez le mode OCR explicite.
--ocr-engine tesseract_cli--ocr-engine tesseractLes valeurs de moteur ont été renommées ; tesserocr reste valide pour le moteur à liaison C.
--table-mode fast (no engine choice)--table-mode fast --table-structure-engine docling_tableformer_v2Vous pouvez maintenant choisir séparément le mode vitesse/précision et le moteur de tableau sous-jacent.
docling --pipeline vlm doc.pdfdocling convert doc.pdf --pipeline vlm --vlm-model granite_doclingLa sélection du pipeline et du modèle a été déplacée sous convert.
docling-tools models downloaddocling-tools models download --allToujours disponible ; --all prétélécharge tous les modèles tandis que les noms simples récupèrent un ensemble précis.
!Notez le changement de --output : il nomme désormais un répertoire, pas un fichier de destination. Utilisez --to pour choisir l'extension.
12
Correctifs

Problèmes courants en un coup d'œil

SymptĂ´meCause et correctif les plus probables
Markdown vide ou presque vide à partir d'un scanPas de couche de texte — ajoutez --ocr-mode full_page.
La conversion est très lenteOCR sur un PDF numérique — ajoutez --no-ocr ; sinon utilisez un GPU (--device).
Caractères corrompus / espaces réservés GLYPHEncodage de police cassé — essayez --pdf-backend pypdfium2.
Mauvaise langue OCRDĂ©finissez --ocr-lang avec les codes du moteur.
GPU non utiliséInstallez une build CUDA/MPS de PyTorch et passez --device cuda|mps.
Le client MCP ne peut pas se connecterUtilisez le bloc JSON exact, pas la commande brute.

Les procédures complètes se trouvent dans Dépannage.

13
?tape 13

Référence complète des options de la CLI

OptionValeurs acceptéesDéfautCe qu'elle fait
--fromrepeatable textall supportedRestreint les formats d'entrée acceptés. Utilisez 'odf' pour odt, ods et odp.
--tomd, json, yaml, html, html_split_page, text, doctags, vtt, doclang, dclx, chunks, latexmdFormat de sortie. Répétez l'option pour exporter plusieurs formats à la fois.
--outputpath.Répertoire où les résultats sont enregistrés (pas un nom de fichier).
--image-export-modeplaceholder, embedded, referencedembeddedComment les images sont exportées pour les sorties JSON, YAML, HTML et Markdown.
--html-image-fetchnone, local, remote, allnoneRécupère les images référencées par les entrées HTML et EPUB.
--page-rangetext (e.g. 1-4)all pagesConvertit uniquement une plage de pages. Pris en charge par PDF, XLSX et PPTX.
--pdf-passwordtext-Mot de passe pour les documents PDF protégés.
--pipelinelegacy, standard, native, vlm, asrstandardPipeline de traitement pour les fichiers PDF et image.
--vlm-modelgranite_docling, smoldocling, deepseek_ocr, granite_vision, pixtral, …granite_doclingPréréglage VLM utilisé avec --pipeline vlm.
--vlm-max-new-tokensintegermodel defaultRemplace max_new_tokens pour la génération VLM.
--vlm-write-native-outputflagfalseÉcrit la réponse VLM non analysée de chaque page sous <output>/<doc>.vlm-native/.
--asr-modelwhisper_tiny … whisper_large, plus _mlx and _native variantswhisper_tinyModèle ASR pour les fichiers audio et vidéo.
--video-sampling-modefixed, scenefixedComment les images vidéo sont échantillonnées.
--video-frame-intervalfloat (seconds)10.0Secondes entre les images en mode intervalle fixe.
--video-diarizationflagfalseActive la séparation des locuteurs (nécessite resemblyzer).
--ocr / --no-ocrflagtrueActive ou désactive l'OCR sur le contenu bitmap.
--ocr-modefull_page, layout_regions, pdf_aware_layout_regions, defaultdefaultQuelles régions du document sont transmises au moteur OCR.
--ocr-engineauto, easyocr, rapidocr, tesserocr, tesseract, ocrmac, nemotron-ocr, kserve_v2_ocrautoFournisseur du moteur OCR.
--ocr-langcomma-separated codesengine defaultLangues OCR ; utilisez les codes natifs du moteur ou les balises BCP-47 préfixées par iso:.
--psminteger 0-13engine defaultPage Segmentation Mode pour les moteurs Tesseract.
--tables / --no-tablesflagtrueActive ou désactive le modèle de structure de tableau.
--table-modeaccurate, fastaccurateCompromis précision/vitesse pour le modèle de structure de tableau.
--table-structure-enginedocling_tableformer, docling_tableformer_v2, granite_vision_tabledocling_tableformerSĂ©lectionne le moteur de structure de tableau.
--layout-enginelayout_object_detection, docling_layout_default, …layout_object_detectionSélectionne le moteur de détection de mise en page.
--enrich-codeflagfalseDĂ©tecte et Ă©tiquette les blocs de code.
--enrich-formulaflagfalseExtrait les formules au format LaTeX.
--enrich-picture-classesflagfalseClasse les images (graphique, schéma, capture…).
--enrich-picture-descriptionflagfalseGénère des descriptions d'images avec un modèle de vision.
--enrich-chart-extractionflagfalseExtrait les données des graphiques à barres, circulaires et linéaires.
--chunks-typehybrid, hierarchicalhybridType de chunker utilisé avec --to chunks.
--chunks-max-tokensintegertokenizer limitNombre maximal de tokens par chunk.
--chunks-tokenizerHuggingFace model idsentence-transformers/all-MiniLM-L6-v2Tokenizer utilisé pour le chunking hybride.
--deviceauto, cpu, cuda, mps, xpuautoAccélérateur matériel pour l'inférence du modèle.
--num-threadsinteger4Threads utilisés pour l'inférence du modèle.
--page-batch-sizeinteger4Pages traitées en un lot.
--document-timeoutfloat (seconds)noneDĂ©lai de traitement pour chaque document.
--abort-on-errorflagfalseArrête toute l'exécution dès que le premier fichier échoue.
--profilingflagfalseRésume le temps passé à chaque étape de conversion.
--artifacts-pathpathHF cacheEmplacement des artefacts de modèle prétéléchargés.
--enable-remote-servicesflagfalseRequis lorsqu'un modèle se connecte à un service distant.
--allow-external-pluginsflagfalseActive le chargement de moteurs plugins tiers.
-v / --verboserepeatable0-v pour les journaux d'information, -vv pour les journaux de débogage.
-q / --quietflagfalseSupprime les journaux de progression par fichier.
--show-layoutflagfalseSuperpose les cadres englobants des éléments sur les images de page.
--debug-visualize-layoutflagfalseVisualise les clusters de mise en page.
--debug-visualize-tablesflagfalseVisualise les cellules de tableau.
--debug-visualize-ocrflagfalseVisualise les cellules OCR.
--versionflag-Affiche la version installée de Docling.
14
?tape 14

Questions sur la CLI Docling

Quelle est la différence entre `docling` et `docling convert` ?
Dans Docling v1, vous pouviez exécuter `docling file.pdf` directement. Dans la v2, la conversion réside dans la sous-commande explicite `docling convert`. Les anciens tutoriels qui omettent `convert` sont écrits pour la v1 et ne fonctionneront pas sur les versions actuelles — utilisez `docling convert file.pdf --to md`.
Pourquoi mon PDF scanné est-il converti en sortie vide ?
Un PDF scanné n'a pas de couche de texte, l'OCR doit donc être forcé. Exécutez `docling convert scan.pdf --ocr-mode full_page`. Si les pages sont des images dans un PDF plus grand, assurez-vous aussi que l'OCR est activé (il l'est par défaut) et qu'un moteur OCR est installé.
Comment rendre la conversion plus rapide ?
Pour les PDF numériques, ajoutez `--no-ocr` (souvent plusieurs fois plus rapide) et ignorez les fonctions inutiles, par exemple `--no-tables`. Utilisez `--device cuda` ou `--device mps` si vous avez un GPU, et ajustez `--num-threads` et `--page-batch-size`. Utilisez `--profiling` pour voir où va réellement le temps.
Quel moteur OCR choisir ?
Commencez par `auto`. RapidOCR est une valeur par défaut multiplateforme solide et économe en CPU. Utilisez `tesseract`/`tesserocr` pour de nombreuses langues, `ocrmac` sur macOS et `nemotron-ocr` uniquement dans un environnement CUDA. Comparez-les sur vos propres documents dans le guide OCR.
Ai-je besoin d'un GPU ?
Non. Docling fonctionne sur CPU. Un GPU accélère surtout les modèles d'OCR et d'enrichissement sur les gros documents. Sur Apple Silicon, utilisez `--device mps` ; sur NVIDIA, `--device cuda`.
OĂą les fichiers convertis sont-ils Ă©crits ?
Par défaut dans le répertoire courant, à côté de l'endroit où vous exécutez la commande. Utilisez `--output ./un/dossier` pour choisir un répertoire. Notez que `--output` est un répertoire, pas un nom de fichier.
Comment convertir de nombreux fichiers ou tout un dossier ?
Passez un répertoire (`docling convert ./inbox --output ./out`), passez plusieurs chemins à la fois, ou utilisez une boucle shell pour un contrôle total. Les commandes de base et les recettes par lots ci-dessus couvrent bash, PowerShell et les exécutions parallèles.
Comment obtenir des chunks pour un système RAG ?
Utilisez `docling convert report.pdf --to chunks --chunks-type hybrid`. Les chunks préservent les titres et la structure des tableaux. Vous pouvez limiter leur taille avec `--chunks-max-tokens` et choisir le tokenizer avec `--chunks-tokenizer`.
Puis-je exécuter Docling entièrement hors ligne ?
Oui. Prétéléchargez les modèles avec `docling-tools models download --all` sur une machine connectée, puis sur l'hôte isolé définissez `DOCLING_ARTIFACTS_PATH` (et `HF_HUB_OFFLINE=1`) et pointez vers le cache copié avec `--artifacts-path`.
Quand utiliser le pipeline VLM plutĂ´t que le pipeline standard ?
Utilisez `--pipeline vlm` pour les pages complexes et visuellement riches où l'analyse de mise en page classique peine, ou lorsque vous voulez un seul modèle de bout en bout. Pour les PDF numériques ordinaires, le pipeline standard est plus rapide et moins coûteux — commencez par celui-ci.
Docling téléverse-t-il mes documents ?
Non. Docling traite les documents localement par défaut et n'envoie aucune télémétrie. Les modèles distants ne sont utilisés que si vous les activez explicitement avec `--enable-remote-services` ou pointez un pipeline vers un service externe.
`--force-ocr` est-il toujours pris en charge ?
Il est obsolète. Utilisez `--ocr-mode full_page`, la méthode prise en charge pour appliquer l'OCR à chaque page et remplacer tout texte existant.