How-to3 dk okuma

Boş tablo dışa aktarma (204): PDF’nizde büyük olasılıkla sütun yok

PDF to Excel ve PDF to CSV tablo bloğu bulunamayınca HTTP 204 döner; bu kasıtlıdır, çökme değil. Önce taramaları OCR edin; yalnızca düzyazı PDF’ler boş kalır.

By the PDF123 team · Updated 2026-10-02
Boş tablo dışa aktarma (204): PDF’nizde büyük olasılıkla sütun yok

PDF to Excel veya PDF to CSV HTTP 204 No Content ile ve indirme gövdesi olmadan biterse, çıkarıcı sıfır tablo bloğu bulmuştur. Bu durum kasıtlıdır: düzen sezgiseli sütun görmeyince API boş bir elektronik tablo uydurmayı reddeder.

Çıkarıcı neye bakar

Her iki araç aynı ardışık düzeni paylaşır. Sunucu pdftotext -layout çalıştırır, sayfaları form feed sınırlarında böler ve sütunlu bloklara benzeyen satırları gruplar. Bir satır, en az iki ardışık boşluk içerdiğinde (layout kipinde sütun aralıkları) tablo satırı sayılır. Bir blok yalnızca en az iki böyle satırı varsa tutulur; tek başına boşluklu bir satır atılır, böylece başlıklar tek satırlık “tablo”lara dönüşmez.

PDF to CSV (POST /api/v1/convert/pdf/csv), algılanan tablo başına bir CSV üretir (sayfa ve tablo diziniyle adlandırılır) ya da birkaç tane olduğunda bir ZIP. PDF to Excel (POST /api/v1/convert/pdf/xlsx), algılanan tablo başına bir sayfayla tek bir çalışma kitabı yazar.

Bu liste boş olduğunda ikisi de 204’e eşlenen Output::no_content() döner. Boş bir .xlsx ile 200, başarı olarak yanlış okunmaya daha açık olurdu; 204 “dışa aktarılacak bir şey yok” demektir.

204 almanızın yaygın nedenleri

  • Yalnızca düzyazı PDF: net sütun hizası olmayan anlatı metni. Bunun yerine PDF to Text veya PDF to Markdown kullanın.
  • Metin katmanı olmayan taranmış sayfalar: pdftotext çıktısı boştur, dolayısıyla tablo görünmez. Önce OCR çalıştırın (bu sitede Markdown metni), sonra yalnızca kelimeler gerçekten sütun oluşturuyorsa yeniden deneyin.
  • Yalnızca çizgi/görüntü olarak çizilmiş tablolar: çıkarılabilir hücre metni olmayan görsel ızgaralar sayfalara dönüşmez.
  • Dağınık çok sütunlu dergi düzenleri: sezgisel, insanın “tablo” dediği blokları kaçırabilir veya okuma sırasını kötü birleştirebilir.
  • Tek satırlık “tablolar”: tek bir boşluklu satır asla blok olmaz; en az iki tablo satırı gerekir.

Şifreli dosyalar, çıkarımdan önce yetkili bir Unlock gerektirir. Get Info veya dışa aktarma dosyayı açamıyorsa hasarlı dosyayı Repair ile onarın.

204 ne değildir

204 bir taşıma hatası, bir zaman aşımı veya “sunucu eki unuttu” değildir. Onu başarılı bir karar olarak alın: tablo bloğu yok. Metin katmanını veya düzeni değiştirmeden aynı dosyayı yeniden denemek yine 204 döner. Betikler boş bir dosya adına değil, durum koduna göre dallanmalıdır.

OCR’dan gelen OCR Markdown, ajanlar için bir metin çıkarımıdır, bir elektronik tablo değil. OCR çıktısını bir .md dosyasına yapıştırıp sonra sütunlara ihtiyaç duyarsanız, hâlâ pdftotext -layout’un (veya bir insanın) aralık olarak görebileceği bir düzen gerekir; metin katmanı olmadan aynı tarama PDF’yi yeniden dışa aktarmak 204 döndürmeye devam eder.

Sırada ne yapmalı

  1. PDF’yi açın ve hücre metnini seçebildiğinizi doğrulayın. Seçemiyorsanız OCR çalıştırın, sonra kurtarılan metnin bu sezgisel için yeterince sütunlu olup olmadığına karar verin.
  2. Birkaç tablo bekliyorsanız PDF to Excel tercih edin (her biri bir sayfa). Tek bir düz dosya veya CSV’lerden oluşan bir ZIP için PDF to CSV tercih edin.
  3. Sayfa anlatıysa aracı değiştirin; tablo dışa aktarma 204 döndürmeye devam eder.
  4. Ajan veya ardışık düzen durum işleme için 204’ü “tablo algılanmadı” olarak eşleyin, genel bir yeniden deneme döngüsü olarak değil.
  5. Yalnızca kelimeler gerekiyorsa PDF to Text veya PDF to Markdown ile durun; düzyazıya elektronik tablo biçimi zorlamak 204 döndürmeye devam eder.

Tarayıcı yolu için hesap gerekmez. Aynı uç noktalar HTTP üzerinden: Geliştiriciler. İstemciniz iki kez POST edebiliyorsa yeniden denemelerde bir Idempotency-Key gönderin (Idempotency-Key).

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