How-to3 min läsning

Tom tabellexport (204): din PDF har troligen inga kolumner

PDF till Excel och PDF till CSV ger HTTP 204 när inga tabellblock hittas, avsiktligt och inte en krasch. Kör OCR på skanningar först; prosa-PDF:er förblir tomma.

By the PDF123 team · Updated 2026-10-02
Tom tabellexport (204): din PDF har troligen inga kolumner

Om PDF till Excel eller PDF till CSV avslutas med HTTP 204 No Content och ingen nedladdningskropp hittade extraheringen noll tabellblock. Den statuskoden är avsiktlig: API:et vägrar hitta på ett tomt kalkylblad när layoutheuristiken inte ser några kolumner.

Vad extraheringen letar efter

Båda verktygen delar samma kedja. Servern kör pdftotext -layout, delar sidorna vid form feed och grupperar rader som ser ut som kolumnblock. En rad räknas som tabellrad när den innehåller minst två mellanslag i följd (kolumnmellanrum i layoutläge). Ett block behålls bara om det har minst två sådana rader; en ensam rad med mellanslag kastas, så att rubriker inte blir ”tabeller” med en enda rad.

PDF till CSV (POST /api/v1/convert/pdf/csv) ger en CSV per upptäckt tabell (namngiven efter sida och tabellindex), eller en ZIP när det finns flera. PDF till Excel (POST /api/v1/convert/pdf/xlsx) skriver en arbetsbok med ett blad per upptäckt tabell.

När listan är tom returnerar båda Output::no_content(), som mappas till 204. Ett 200 med en tom .xlsx vore lättare att misstolka som framgång; 204 betyder ”inget att exportera”.

Vanliga skäl till 204

  • PDF med bara prosa: berättande text utan tydlig kolumnjustering. Använd PDF till text eller PDF till Markdown i stället.
  • Skannade sidor utan textlager: pdftotext ger inget utdata, så inga tabeller syns. Kör OCR först (Markdown-text hos oss) och försök sedan igen bara om orden verkligen bildar kolumner.
  • Tabeller som bara är ritade linjer eller bilder: visuella rutnät utan extraherbar celltext blir inga kalkylblad.
  • Stökiga tidskriftslayouter i flera kolumner: heuristiken kan missa block som en människa kallar tabeller, eller blanda ihop läsordningen.
  • ”Tabeller” med en enda rad: en rad med mellanslag blir aldrig ett block; du behöver minst två tabellrader.

Krypterade filer kräver en behörig upplåsning via Ta bort lösenord före extraheringen. Reparera en skadad fil med Reparera PDF om Dokumentinfo eller exporten inte kan öppna den.

Vad 204 inte är

204 är inte ett transportfel, inte en timeout och inte ”servern glömde bilagan”. Behandla det som ett lyckat beslut: inga tabellblock. Att försöka igen med samma fil utan att ändra textlager eller layout ger 204 igen. Skript bör förgrena sig på statuskoden, inte på ett tomt filnamn.

OCR-Markdown från OCR är en textextraktion för agenter, inte ett kalkylblad. Klistrar du in OCR-resultatet i en .md-fil och senare behöver kolumner krävs fortfarande en layout som pdftotext -layout (eller en människa) uppfattar som kolumnmellanrum; att exportera om samma skannade PDF utan textlager ger fortsatt 204.

Vad du gör härnäst

  1. Öppna PDF:en och bekräfta att du kan markera texten i cellerna. Om inte, kör OCR och avgör sedan om den återvunna texten är tillräckligt kolumnformad för heuristiken.
  2. Använd hellre PDF till Excel när du väntar dig flera tabeller (ett blad per tabell). Använd hellre PDF till CSV för en enda platt fil eller en ZIP med CSV-filer.
  3. Om sidan är berättande, byt verktyg; tabellexporten fortsätter ge 204.
  4. För statushantering i agenter eller kedjor, mappa 204 till ”inga tabeller hittades”, inte till en allmän återförsöksslinga.
  5. Behöver du bara orden, stanna vid PDF till text eller PDF till Markdown; att tvinga på prosa en kalkylbladsform ger fortsatt 204.

Inget konto krävs för vägen via webbläsaren. Samma slutpunkter över HTTP: Utvecklare. Skicka en Idempotency-Key vid återförsök om din klient kan tänkas skicka samma POST två gånger (Idempotency-Key).

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