How-to3 min de lecture

Export de tableau vide (204) : votre PDF n’a probablement pas de colonnes

PDF vers Excel et PDF vers CSV renvoient HTTP 204 sans bloc de tableau détecté : voulu, pas un plantage. Passez les scans à l’OCR, la prose seule reste vide.

By the PDF123 team · Updated 2026-10-02
Export de tableau vide (204) : votre PDF n’a probablement pas de colonnes

Si PDF vers Excel ou PDF vers CSV se termine par HTTP 204 No Content sans corps de téléchargement, l’extracteur n’a trouvé aucun bloc de tableau. Ce statut est délibéré : l’API refuse d’inventer un tableur vide quand l’heuristique de mise en page ne voit aucune colonne.

Ce que l’extracteur recherche

Les deux outils partagent la même chaîne de traitement. Le serveur lance pdftotext -layout, découpe les pages aux frontières de saut de page, puis regroupe les lignes qui ressemblent à des blocs en colonnes. Une ligne est considérée comme tabulaire lorsqu’elle contient au moins deux espaces consécutifs (les gouttières de colonnes du mode layout). Un bloc n’est conservé que s’il compte au moins deux lignes de ce type ; une ligne isolée avec des espaces est écartée pour que les titres ne deviennent pas des « tableaux » d’une seule ligne.

PDF vers CSV (POST /api/v1/convert/pdf/csv) produit un CSV par tableau détecté (nommé d’après la page et l’index du tableau), ou un ZIP lorsqu’il y en a plusieurs. PDF vers Excel (POST /api/v1/convert/pdf/xlsx) écrit un classeur avec une feuille par tableau détecté.

Quand cette liste est vide, les deux renvoient Output::no_content(), associé à 204. Un 200 accompagné d’un .xlsx vide serait plus facile à confondre avec un succès ; 204 signifie « rien à exporter ».

Les causes fréquentes d’un 204

  • PDF de prose seule : texte narratif sans alignement de colonnes net. Utilisez plutôt PDF vers texte ou PDF vers Markdown.
  • Pages scannées sans couche de texte : la sortie de pdftotext est vide, donc aucun tableau n’apparaît. Lancez d’abord OCR (qui renvoie du Markdown sur ce site), et ne réessayez que si les mots forment réellement des colonnes.
  • Tableaux dessinés uniquement en traits ou en images : une grille visuelle sans texte de cellule extractible ne devient pas une feuille.
  • Mises en page de magazine multicolonnes désordonnées : l’heuristique peut manquer des blocs qu’un humain qualifierait de « tableau », ou fusionner l’ordre de lecture de travers.
  • « Tableaux » d’une seule ligne : une ligne espacée ne forme jamais un bloc ; il faut au moins deux lignes tabulaires.

Les fichiers chiffrés exigent un Déverrouiller autorisé avant l’extraction. Réparez un fichier endommagé avec Réparer si Get Info ou l’export ne parvient pas à l’ouvrir.

Ce que 204 n’est pas

204 n’est pas une panne de transport, ni un délai d’attente dépassé, ni « le serveur a oublié la pièce jointe ». Considérez ce statut comme une décision réussie : aucun bloc de tableau. Relancer le même fichier sans modifier la couche de texte ni la mise en page renverra encore 204. Un script doit tester le code de statut, pas un nom de fichier vide.

Le Markdown issu de OCR est une extraction de texte destinée aux agents, pas un tableur. Si vous collez cette sortie dans un .md et avez ensuite besoin de colonnes, il vous faut toujours une mise en page où pdftotext -layout (ou un humain) distingue des gouttières ; réexporter le même PDF scanné sans couche de texte continuera de renvoyer 204.

Que faire ensuite

  1. Ouvrez le PDF et vérifiez que vous pouvez sélectionner le texte des cellules. Sinon, lancez OCR, puis jugez si le texte récupéré est assez colonnaire pour cette heuristique.
  2. Préférez PDF vers Excel lorsque vous attendez plusieurs tableaux (une feuille chacun). Préférez PDF vers CSV pour un fichier plat unique ou un ZIP de CSV.
  3. Si la page est narrative, changez d’outil ; l’export de tableau continuera de renvoyer 204.
  4. Pour la gestion de statut par un agent ou une chaîne de traitement, associez 204 à « aucun tableau détecté », pas à une boucle de nouvelles tentatives générique.
  5. Si vous n’avez besoin que des mots, arrêtez-vous à PDF vers texte ou PDF vers Markdown ; forcer une forme de tableur sur de la prose continuera de renvoyer 204.

Aucun compte n’est nécessaire pour l’usage dans le navigateur. Mêmes points de terminaison en HTTP : Développeurs. Envoyez un Idempotency-Key sur les nouvelles tentatives si votre client risque d’envoyer deux POST (Idempotency-Key).

Open tool
Process in the browser — no watermark, files removed after the job.
Open tool