Ιστολόγιο

PDF στο Claude Code: μετατροπή, tokens και διατήρηση της δομής

Markdown

MarkItDown, PyMuPDF4LLM, MCP, πλήρη σενάρια μετατροπής, όρια PDF και περιπτώσεις όπου η οπτική ανάλυση έχει μεγαλύτερη σημασία από την εξοικονόμηση token.

Διαβάστε ολόκληρο το άρθρο

Κύριο συμπέρασμα

Κάθε σελίδα PDF στο Claude Code κοστίζει 1.500–3.000 tokens πριν από την πρώτη ερώτηση — και η Anthropic το αναφέρει ξεκάθαρα στην τεκμηρίωσή της. Στον ενδεικτικό υπολογισμό παρακάτω, μια αναφορά 15 σελίδων σε 4 διαφορετικές συνομιλίες χρησιμοποιεί 135,000 tokens εισόδου PDF με περίπου $0.40 έναντι 18,000 tokens Markdown με $0.054 — περίπου 87% λιγότερο. Αυτό υποθέτει 2,250 tokens PDF ή 300 Markdown ανά σελίδα στην τιμή εισόδου του παραδείγματος· τα πραγματικά έγγραφα διαφέρουν. Αυτός ο οδηγός παρουσιάζει τρεις μεθόδους μετατροπής (MarkItDown, PyMuPDF4LLM και έναν διακομιστή MCP), καθώς και ένα έτοιμο σενάριο bash για έναν φάκελο εγγράφων.

Πρακτικές οδηγίες για τη χρήση του Ailoot θα βρείτε στην τεκμηρίωση.

Τι συμβαίνει σε ένα PDF στο Claude και γιατί κοστίζει 1.500–3.000 tokens κάθε σελίδα;

Κύριο συμπέρασμα

Όταν ανεβάζετε ένα PDF στο Claude Code, δεν το διαβάζει ως αρχείο κειμένου. Πρώτα, κάθε σελίδα μετατρέπεται σε εικόνα, έπειτα εξάγεται το κείμενό της και τα δύο επίπεδα —η εικόνα και το κείμενο— προστίθενται μαζί στο πλαίσιο συμφραζομένων. Γι’ αυτό μία σελίδα καταλαμβάνει 1.500–3.000 tokens και ένα έγγραφο 50 σελίδων μπορεί να χρησιμοποιήσει 75.000–150.000 tokens προτού κάνετε την πρώτη σας ερώτηση.

Η επίσημη τεκμηρίωση της Anthropic περιγράφει τη διαδικασία σε τρία απλά βήματα:

Το σύστημα μετατρέπει κάθε σελίδα του εγγράφου σε εικόνα. Το κείμενο από κάθε σελίδα εξάγεται και παρέχεται μαζί με την εικόνα της σελίδας. Το Claude αναλύει τόσο το κείμενο όσο και τις εικόνες για να κατανοήσει καλύτερα το έγγραφο.

— Anthropic, https://platform.claude.com/docs/en/docs/build-with-claude/pdf-support

Ακούγεται λογικό, αλλά το κόστος επεξεργασίας αυξάνεται γραμμικά με τον αριθμό των σελίδων. Και αυτό είναι το στοιχείο που εξηγεί γιατί εξαντλείται το όριο της συνδρομής σας με ένα μόνο PDF:

Κάθε σελίδα συνήθως χρησιμοποιεί 1.500–3.000 tokens, ανάλογα με την πυκνότητα του περιεχομένου. Επειδή κάθε σελίδα μετατρέπεται σε εικόνα, ισχύει το ίδιο κόστος όπως και για τις τυπικές εικόνες.

— Anthropic, https://platform.claude.com/docs/en/docs/build-with-claude/pdf-support

Για να δείτε πόσο είναι αυτό, η Anthropic μέτρησε το ίδιο PDF 3 σελίδων στο Bedrock με δύο τρόπους. Σε λειτουργία κειμένου (Converse Document Chat), χρησιμοποίησε ~1.000 tokens. Με οπτική ανάλυση (Claude PDF Chat), χρησιμοποίησε ~7.000 tokens. Η συμπερίληψη εικόνων κάνει την επεξεργασία 7 φορές ακριβότερη.

Τα στιγμιότυπα οθόνης σελίδων είναι ακόμη χειρότερα. Ένα στιγμιότυπο οθόνης 1000×1000 pixel κοστίζει περίπου 1.300 tokens.

Ο μηχανισμός είναι απλός: τα PDF είναι ακριβά επειδή το Claude δεν εμπιστεύεται το OCR του. Χρησιμοποιεί και το κείμενο και την εικόνα για να τα συγκρίνει — και πληρώνετε ταυτόχρονα και για τα δύο επίπεδα. Για μεγάλα έγγραφα, μπορείτε να κάνετε κάτι διαφορετικό: να αποθηκεύσετε το αρχείο ως Markdown στον φάκελο του έργου σας και να πείτε στο Claude: «ορίστε ένα έγγραφο με πληροφορίες — ξεδίπλωσέ τες». Θα κατανείμει το περιεχόμενο στα δικά του αρχεία και θα συνεχίσει να δουλεύει με το οργανωμένο κείμενο αντί να καταναλώνει τα πάντα μονομιάς.

Πόσο καταναλώνει ένα PDF σε μια τυπική εργασία;

Κύριο συμπέρασμα

Σκεφτείτε δημόσια αναφορά 15 σελίδων σε 4 διαφορετικά πλαίσια — ανάλυση, αποσπάσματα, μετάφραση και σύνοψη. Υποθέστε 2,250 tokens εισόδου ανά σελίδα PDF, 300 ανά μετατραπείσα σελίδα Markdown και ίδια τιμή εισόδου και για τα δύο. Η επαναφόρτωση PDF δίνει 135,000 tokens εισόδου, περίπου $0.40· το Markdown 18,000 ή $0.054. Η εξοικονόμηση περίπου 87% προκύπτει από τις παραδοχές, όχι από μέτρηση κάθε PDF.

Οι συγκεκριμένοι αριθμοί (μοντέλο Sonnet 4.x, είσοδος με 3 $ ανά εκατομμύριο tokens):

ΠροσέγγισηTokens (15 σελίδες, 4 συνομιλίες)Κόστος
Απευθείας μεταφόρτωση PDF 4 φορές15 × 2250 × 4 = 135.000~0,40 $
PDF → Markdown + 4 συνομιλίες15 × 300 × 4 = 18.000~0,054 $
Εξοικονόμηση−87%−0,35 $

Και αυτό αφορά μόνο έναν κύκλο 4 αιτημάτων. Έπειτα μπαίνει στο παιχνίδι η προσωρινή αποθήκευση προτροπών (TTL 5 λεπτών από προεπιλογή, έως και 1 ώρα σε εκτεταμένο επίπεδο, με έκπτωση έως 90% στις επαναλαμβανόμενες κλήσεις εντός του χρονικού παραθύρου) — και η εξοικονόμηση πολλαπλασιάζεται.

Κάθε φορά που ανεβάζετε το ίδιο PDF σε νέα συνομιλία, το Claude το διαβάζει ξανά· η προσωρινή μνήμη δεν μεταφέρεται από συνομιλία σε συνομιλία.

Αν μετατρέψετε μία φορά το ίδιο PDF 15 σελίδων σε Markdown και το εισάγετε σε καθεμία από τέσσερις νέες συνομιλίες ως .md, το παράδειγμα χρησιμοποιεί 15 × 300 × 4 = 18,000 tokens εισόδου αντί 135,000. Τα 300 tokens ανά μετατραπείσα σελίδα και 2,250 ανά σελίδα PDF είναι παραδοχές υπολογισμού, όχι μετρημένες σταθερές κάθε PDF. Μετρήστε το πραγματικό έγγραφο και επιβεβαιώστε ποιότητα μετατροπής πριν εκτιμήσετε εξοικονόμηση.

Οι υπολογισμοί έχουν ακόμη μεγαλύτερη σημασία με συνδρομή Claude Pro. Μία αναφορά 100 σελίδων μπορεί να εξαντλήσει ολόκληρο το όριο των 5 ωρών. Μετά τη μετατροπή σε Markdown, χωρούν 10+ τέτοια έγγραφα στον ίδιο προϋπολογισμό.

Ποια είναι τα όρια του Anthropic API για PDF το 2026;

Κύριο συμπέρασμα

Η Anthropic έχει αυστηρά όρια: έως 32 MB ανά αίτημα (συμπεριλαμβανομένου όλου του περιεχομένου, όχι μόνο του PDF) και έως 600 σελίδες ανά αίτημα. Όμως το όριο είναι χαμηλότερο για τα τρέχοντα μοντέλα Sonnet 4.x και Opus 4.x με πλαίσιο συμφραζομένων 200K: 100 σελίδες. Μπορείτε να στείλετε ένα PDF με τρεις τρόπους: μέσω URL, σε Base64 ή μέσω του Files API για επαναχρησιμοποίηση με file_id. Το Files API μαζί με τον διαχωρισμό σε μέρη χρησιμοποιείται για μεγάλα έγγραφα.

Η τεκμηρίωση της Anthropic αναφέρει τα όρια στην αρχή της σελίδας (ισχύουν στις 31 Μαΐου 2026):

ΑπαίτησηΌριο
Μέγιστο μέγεθος αιτήματος32 MB (διαφέρει ανά πλατφόρμα)
Μέγιστες σελίδες ανά αίτημα600 (100 για μοντέλα με πλαίσιο συμφραζομένων 200K tokens)
ΜορφήΤυπικό PDF χωρίς κωδικούς πρόσβασης ή κρυπτογράφηση

Και τα δύο όρια ισχύουν για ολόκληρο το σώμα του αιτήματος, συμπεριλαμβανομένου του περιεχομένου που συνοδεύει το PDF. Για μεγάλα PDF, χρησιμοποιήστε το Files API και αναφερθείτε σε αυτά με το file_id, ώστε το σώμα του αιτήματος να παραμένει μικρό.

— Anthropic, https://platform.claude.com/docs/en/docs/build-with-claude/pdf-support

Το Claude.ai (η καταναλωτική διαδικτυακή εφαρμογή) έχει διαφορετικά όρια: έως 500 MB ανά αρχείο και έως 20 αρχεία σε μία συνομιλία. Ωστόσο, η οπτική ανάλυση λειτουργεί μόνο για PDF έως 100 σελίδων — πέρα από αυτό, το Claude βλέπει μόνο κείμενο, χωρίς γραφήματα και διαγράμματα.

Τρεις τρόποι αποστολής PDF μέσω API:

  1. Μέσω URL - "source": {"type": "url", "url": "..."} - η απλούστερη επιλογή όταν το έγγραφο είναι online.
  2. Σε Base64 - "source": {"type": "base64", "media_type": "application/pdf", "data": "..."} - για τοπικά αρχεία.
  3. Μέσω του Files API - "source": {"type": "file", "file_id": "file_abc123"} - για επαναλαμβανόμενα αιτήματα· απαιτεί την κεφαλίδα beta anthropic-beta: files-api-2025-04-14.

Το Files API είναι ο βασικός τρόπος εξοικονόμησης όταν εργάζεστε με το ίδιο PDF σε διαφορετικές συνομιλίες. Ανεβάστε το μία φορά, λάβετε ένα file_id και έπειτα όλες οι αλληλεπιδράσεις το χρησιμοποιούν. Με cache_control: ephemeral, οι επαναλαμβανόμενες κλήσεις κοστίζουν το 10% της κανονικής τιμής.

Η Anthropic παρέχει επίσης επίσημες συμβουλές για τη μείωση της χρήσης:

Τα πυκνά PDF (με πολύ μικρό κείμενο, σύνθετους πίνακες ή πολλά γραφικά) μπορεί να γεμίσουν το παράθυρο συμφραζομένων πριν φτάσετε το όριο σελίδων. Δοκιμάστε να χωρίσετε το έγγραφο σε ενότητες· για μεγάλα αρχεία, μειώστε την ανάλυση των ενσωματωμένων εικόνων πριν από τη μεταφόρτωση.

— Anthropic, https://platform.claude.com/docs/en/docs/build-with-claude/pdf-support

Μέθοδος 1: Πώς ρυθμίζετε το MarkItDown σε 5 λεπτά;

Κύριο συμπέρασμα

Το MarkItDown είναι ένα εργαλείο Python από την ομάδα Microsoft AutoGen που μετατρέπει PDF, DOCX, PPTX, XLSX, HTML, ήχο, εικόνες, ακόμη και βίντεο YouTube σε καθαρό Markdown. Έχει 134 χιλιάδες αστέρια στο GitHub, άδεια MIT και εγκαθίσταται με μία εντολή: pip install 'markitdown[all]'. Είναι εξίσου εύκολο στη χρήση: markitdown document.pdf > document.md. Το πιο ευέλικτο εργαλείο για τη μετατροπή αρχείων πριν από τη χρήση του Claude Code.

Το MarkItDown είναι επίσημο έργο της Microsoft, το οποίο συντηρεί η ομάδα AutoGen. Στο GitHub έχει 134 χιλιάδες αστέρια και 9,2 χιλιάδες forks (στα τέλη Μαΐου 2026). Ο σκοπός του περιγράφεται άμεσα στο README:

Ένα ελαφρύ εργαλείο Python για τη μετατροπή αρχείων σε Markdown, για χρήση με LLM και ροές εργασίας ανάλυσης κειμένου.

— Microsoft, https://github.com/microsoft/markitdown

Υποστηριζόμενες μορφές:

  • Έγγραφα: PDF, DOCX, PPTX, XLSX
  • Ιστός: HTML, JSON, XML, CSV
  • Πολυμέσα: ήχος με απομαγνητοφώνηση, εικόνες με EXIF και OCR, βίντεο YouTube (μέσω υποτίτλων)
  • Αρχεία: ZIP, EPub
  • Άλλα: όλα τα συνημμένα μέσα σε αρχεία Outlook MSG

Εγκατάσταση

Απαίτηση: Python 3.10+ (συνήθως είναι ήδη εγκατεστημένο στο macOS· στα Windows πρέπει να το εγκαταστήσετε ξεχωριστά).

pip install 'markitdown[all]'

Αν δεν χρειάζεστε όλες τις μορφές, μπορείτε να εγκαταστήσετε επιλεγμένες:

pip install 'markitdown[pdf, docx, pptx]'

Μετατροπή ενός αρχείου

Η απλούστερη περίπτωση:

markitdown document.pdf > document.md

Έπειτα, το document.md θα εμφανιστεί στον τρέχοντα φάκελο. Εισαγάγετέ το στο Claude Code με το @document.md ή απλώς τοποθετήστε το δίπλα στο έργο σας.

Python API

Αν θέλετε να το ενσωματώσετε στο σενάριό σας:

from markitdown import MarkItDown

md = MarkItDown()
result = md.convert("research-paper.pdf")
print(result.text_content)

# You can save it straight away:
with open("research-paper.md", "w") as f:
    f.write(result.text_content)

Τι ΔΕΝ μπορεί να κάνει το MarkItDown

  • OCR για σαρωμένα PDF - δεν επιστρέφει τίποτα. Για σαρώσεις χρειάζεστε PyMuPDF4LLM ή Docling.
  • Σύνθετες διατάξεις με πολλές στήλες - μπορεί να ανακατέψει τη σειρά ανάγνωσης.
  • Ενσωματωμένους συνδέσμους URL από PDF - δεν τους διατηρεί.

Για απλά PDF (αναφορές, άρθρα, τεκμηρίωση), το MarkItDown είναι η καλύτερη επιλογή: ένα ευέλικτο εργαλείο που εγκαθίσταται σε ένα λεπτό και δεν απαιτεί γνώσεις Python. Η απόδοσή του σε έγγραφα με κυριλλικό κείμενο και σαρωμένα έγγραφα παρουσιάζεται στις μετρήσεις της ανάλυσης για το πώς να μετατρέψετε ένα PDF σε κείμενο για AI.

Μέθοδος 2: Τι προσφέρει το PyMuPDF4LLM και πότε είναι καλύτερο;

Κύριο συμπέρασμα

Το PyMuPDF4LLM είναι έργο της Artifex Software που βασίζεται στην εγγενή μηχανή C MuPDF. Είναι ο ταχύτερος μετατροπέας PDF (δεν χρειάζεται GPU)· εφαρμόζει έξυπνο OCR μόνο σε δυσανάγνωστες περιοχές και μειώνει τον χρόνο επεξεργασίας κατά 50%. Είναι το μόνο δημοφιλές εργαλείο που διατηρεί ενσωματωμένους συνδέσμους και εικόνες από PDF. Το μειονέκτημα είναι η διπλή άδεια AGPL v3 / εμπορική άδεια Artifex: για έργα SaaS, η AGPL σημαίνει ότι πρέπει να δημοσιεύσετε τον κώδικά σας.

Το MarkItDown προσφέρει εύρος μορφών· το PyMuPDF4LLM προσφέρει βάθος στην επεξεργασία PDF.

Μια ελαφριά επέκταση του PyMuPDF που μετατρέπει PDF σε καθαρά, δομημένα δεδομένα με ελάχιστη ρύθμιση.

— Artifex Software, https://pymupdf.readthedocs.io/en/latest/pymupdf4llm/

Η έκδοση στις 31 Μαΐου 2026 είναι η 1.27.2.3 (κυκλοφόρησε στις 24 Απριλίου 2026).

Τι περιλαμβάνει

  • Σελίδες με πολλές στήλες και σωστή σειρά ανάγνωσης
  • Πίνακες που μετατρέπονται σε Markdown με σύνταξη GitHub
  • Αυτόματη αφαίρεση κεφαλίδων και υποσέλιδων
  • Εξαγωγή εικόνων με σχετικούς συνδέσμους σε ξεχωριστό φάκελο
  • Έξυπνο OCR: εφαρμόζεται μόνο σε δυσανάγνωστες περιοχές, εξοικονομώντας ~50% του χρόνου επεξεργασίας
  • Εγγενής μηχανή C, δεν χρειάζεται GPU

Εγκατάσταση

pip install pymupdf4llm

Χρήση

import pymupdf4llm

# Basic use - straight to Markdown:
md_text = pymupdf4llm.to_markdown("document.pdf")

# Save it:
with open("document.md", "w") as f:
    f.write(md_text)

Με μία γραμμή, όπως υποσχεθήκαμε:

python3 -c "import pymupdf4llm; \
  open('document.md','w').write(pymupdf4llm.to_markdown('document.pdf'))"

Πότε να επιλέξετε PyMuPDF4LLM αντί για MarkItDown

  • Όταν το PDF περιέχει πολλούς συνδέσμους που θέλετε να διατηρήσετε (το MarkItDown τους χάνει).
  • Όταν το έγγραφο είναι σαρωμένο και χρειάζεστε OCR.
  • Όταν χρειάζεστε ταχύτητα σε χιλιάδες τοπικά αρχεία — η εγγενής μηχανή C είναι ταχύτερη από περιτυλίγματα Python.
  • Όταν χρειάζεστε τις εικόνες του PDF σε ξεχωριστό φάκελο για περαιτέρω επεξεργασία.

Λεπτομέρειες αδειοδότησης (σημαντικές για επιχειρήσεις)

Το PyMuPDF4LLM διατίθεται με διπλή άδεια: AGPL v3 Ή εμπορική άδεια Artifex.

AGPL σημαίνει: αν χρησιμοποιείτε τη βιβλιοθήκη σε δημόσια υπηρεσία SaaS, πρέπει να δημοσιεύσετε ολόκληρο τον πηγαίο κώδικα της υπηρεσίας σας υπό την ίδια AGPL. Για εσωτερική χρήση (το σενάριό σας στον φορητό υπολογιστή σας), δεν υπάρχουν περιορισμοί.

Για εμπορική ανάπτυξη χωρίς αποκάλυψη κώδικα, αγοράστε άδεια από την Artifex (artifex.com). Οι τιμές δεν δημοσιεύονται· ζητήστε τις από το τμήμα πωλήσεων.

Αν αναπτύσσετε προϊόν για πελάτες, ελέγξτε την άδεια από την αρχή. Το MarkItDown (MIT) και το Docling (MIT) είναι ασφαλέστερες επιλογές για SaaS.

Μέθοδος 3: Πώς συνδέετε τον διακομιστή MarkItDown MCP με το Claude Code;

Κύριο συμπέρασμα

Ο διακομιστής MarkItDown MCP είναι το ίδιο MarkItDown ενσωματωμένο στο πρωτόκολλο MCP, ώστε το Claude Code να μπορεί να μετατρέπει PDF επιτόπου χωρίς να φορτώνει το αρχικό αρχείο στο πλαίσιο συμφραζομένων. Συνδέστε τον με μία μόνο εντολή μέσω uv· η έκδοση είναι κλειδωμένη: markitdown-mcp@0.0.1a7. Το εργαλείο που λαμβάνει το Claude είναι το convert_to_markdown(uri). Το κόστος αδράνειας είναι ~110 tokens για την περιγραφή της δεξιότητας και μηδενικό όταν δεν χρειάζεται.

Το MarkItDown σε λειτουργία CLI σημαίνει «μετατρέπω τα αρχεία χειροκίνητα εκ των προτέρων»· ο διακομιστής MCP σημαίνει «το Claude Code αποφασίζει πότε θα γίνει η μετατροπή».

Εγκατάσταση

Χρειάζεστε τον διαχειριστή πακέτων uv. Δεν χρειάζεται να εγκαταστήσετε ξεχωριστά τον διακομιστή· το uv τον κατεβάζει την πρώτη φορά που εκτελείται.

Ρύθμιση στο Claude Code

Μία εντολή συνδέει τον διακομιστή με όλα τα έργα σας και κλειδώνει την έκδοση:

claude mcp add --scope user --env 'ORT_DISABLE_TELEMETRY=1' --env 'UV_PYTHON=3.12' --transport stdio markitdown -- uvx markitdown-mcp@0.0.1a7
claude mcp list

Η εγγραφή markitdown θα πρέπει να εμφανίζει την ένδειξη “Connected.” Η πρώτη εκκίνηση κατεβάζει περίπου εβδομήντα πακέτα και διαρκεί έως ένα λεπτό· έπειτα ο διακομιστής ξεκινά σε ένα ή δύο δευτερόλεπτα.

Να γιατί η εντολή χρειάζεται τις δύο μεταβλητές. Η ORT_DISABLE_TELEMETRY=1 απενεργοποιεί τα στατιστικά που στέλνει από προεπιλογή στη Microsoft η μηχανή onnxruntime στο εσωτερικό του διακομιστή σε Mac και Linux. Η UV_PYTHON=3.12 εκτελεί τον διακομιστή με Python 3.12, για την οποία υπάρχουν έτοιμα πακέτα σε Windows, Linux και Mac με Apple Silicon. Σε Mac Intel και σε macOS 13 και παλαιότερα, ο διακομιστής δεν εγκαθίσταται με Python 3.14. Υπάρχει μια επιφύλαξη για Intel και την 3.12: το uv θα μεταγλωττίσει τη βιβλιοθήκη cryptography από τον πηγαίο κώδικα, επειδή δεν υπάρχει διαθέσιμο έτοιμο πακέτο Intel από τον Ιούνιο του 2026. Η εγκατάσταση διαρκεί περισσότερο και μπορεί να αποτύχει. Αν δεν έχετε Python 3.12, το uv θα την κατεβάσει για εσάς.

Ο διακομιστής εκτελείται απευθείας στον υπολογιστή σας και μπορεί να ανοίξει οποιοδήποτε αρχείο έχετε δικαίωμα να προσπελάσετε. Αν το Claude Code ήταν ήδη ανοιχτό, επανεκκινήστε το και το markitdown θα εμφανιστεί στη λίστα διακομιστών MCP.

Τρόπος χρήσης

Στο Claude Code, απλώς πείτε:

Convert /Users/your-user/Documents/report.pdf to Markdown and analyze the main points.

Το Claude καλεί μόνο του το convert_to_markdown(uri), λαμβάνει το Markdown και δουλεύει με αυτό — το PDF δεν φορτώνεται καθόλου στο πλαίσιο συμφραζομένων.

Υποστηριζόμενα URI

  • file:// - τοπικά αρχεία
  • http://, https:// - διαδικτυακά έγγραφα
  • data: - ενσωματωμένα δεδομένα (Base64)

Ασφάλεια

Από το επίσημο README:

Ο διακομιστής δεν υποστηρίζει εξουσιοδότηση και εκτελείται με τα δικαιώματα του χρήστη που τον ξεκίνησε.

— Microsoft, https://github.com/microsoft/markitdown/tree/main/packages/markitdown-mcp

Από προεπιλογή, συνδέεται στο localhost. Αν τον εκτελείτε μέσω HTTP/SSE (επιλογή --http --host 127.0.0.1 --port 3001), μην εκθέτετε τη θύρα εξωτερικά χωρίς αντίστροφο διακομιστή μεσολάβησης που απαιτεί έλεγχο ταυτότητας.

Ποια μέθοδο να επιλέξετε για την εργασία σας;

Κύριο συμπέρασμα

Το MarkItDown είναι η ολοκληρωμένη επιλογή αν εργάζεστε με διαφορετικές μορφές (PDF + DOCX + PPTX + YouTube) και χρειάζεστε μια γρήγορη εντολή CLI. Το PyMuPDF4LLM είναι ο ειδικός στα PDF: ταχύτερο, με OCR και διατήρηση συνδέσμων, αλλά με παγίδα AGPL για SaaS. Το Docling είναι κατάλληλο για παραγωγική χρήση και χειρίζεται καλύτερα πίνακες και τύπους. Το Marker προορίζεται για επιστημονικές εργασίες με μαθηματικά. Ο διακομιστής MCP είναι για όταν δεν θέλετε να ασχοληθείτε με τη μετατροπή και θέλετε να αφήσετε το Claude Code να αποφασίσει μόνο του.

Εκτεταμένος συγκριτικός πίνακας:

ΕργαλείοΑστέρια στο GitHubΚατάλληλο γιαΤαχύτηταΆδεια
MarkItDown (Microsoft)134kPDF + DOCX + PPTX + YouTube + ήχοΜέτριαMIT
PyMuPDF4LLM (Artifex)-Εγγενές PDF, OCR, ενσωματωμένοι σύνδεσμοι URLΗ ταχύτερη (χωρίς GPU)AGPL v3 / εμπορική
Docling (IBM Research)60.7kΠαραγωγικό RAG, πίνακες, τύποιΜέτριαMIT
Marker (datalab.to)35.6kΕπιστημονικά PDF, arXiv, τύποιΥψηλή (με GPU)GPL-3.0 + Open Rail-M
MinerU-Έγγραφα CJK (Κινεζικά/Ιαπωνικά)ΥψηλήApache-2.0

Το Marker δημοσιεύει εντυπωσιακά στοιχεία ακρίβειας σε σημεία αναφοράς:

0,18 δευτερόλεπτα ανά σελίδα σε GPU H100 (122 σελίδες ανά δευτερόλεπτο). Ακρίβεια 95,67% έναντι 84,24% του Llamaparse και 86,43% του Mathpix. Σε επιστημονικές εργασίες, 96,67%.

— datalab.to, https://github.com/datalab-to/marker

Όμως το Marker χρειάζεται GPU για καλή ταχύτητα και συνοδεύεται από μοντέλα μηχανικής μάθησης. Για τις περισσότερες εργασίες (συνηθισμένα PDF με κείμενο), το PyMuPDF4LLM ή το MarkItDown κάνουν τη δουλειά χωρίς GPU μέσα σε λίγα δευτερόλεπτα.

Ένας απλός κανόνας επιλογής

  1. Ένα ή δύο PDF, χρειάζεστε γρήγορη λύση - MarkItDown CLI.
  2. Δεκάδες PDF, χρειάζεστε αυτοματοποίηση - διακομιστής MarkItDown MCP ή PyMuPDF4LLM σε σενάριο.
  3. PDF με συνδέσμους και εικόνες όπου έχει σημασία η διατήρηση της δομής - PyMuPDF4LLM.
  4. Παραγωγικό RAG για επιχειρήσεις όπου έχει σημασία η σταθερότητα των πινάκων - Docling.
  5. Επιστημονικές εργασίες με τύπους - Marker.
  6. Δεν θέλετε να ασχοληθείτε· αφήστε το Claude να μετατρέψει το PDF - διακομιστής MarkItDown MCP.

Πώς γράφετε ένα έτοιμο σενάριο για αυτόματη μετατροπή φακέλου εγγράφων;

Κύριο συμπέρασμα

Το πιο βολικό μοτίβο είναι ένα σενάριο bash που διατρέχει έναν φάκελο έργου, μετατρέπει όλα τα αρχεία PDF, DOCX και PPTX σε Markdown και τα τοποθετεί σε υποφάκελο _md/. Ρυθμίστε το μία φορά και κάθε νέος φάκελος εγγράφων θα γίνεται «αναγνώσιμος από το Claude» με ένα πέρασμα. Έπειτα εισαγάγετε τον _md/ στο Claude Code με το @_md/ και δουλέψτε με το συμπυκνωμένο κείμενο.

Ένα πρακτικό παράδειγμα: φανταστείτε ότι έχετε 40 αναφορές PDF και PPTX από πελάτες σε έναν φάκελο — καταστάσεις χρηματιστηριακών λογαριασμών, συμβάσεις, παρουσιάσεις. Δεν έχει νόημα να ανεβάσετε ολόκληρο τον φάκελο στο Claude: το παράθυρο συμφραζομένων θα γεμίσει με πληροφορίες πριν από την πρώτη απάντηση. Περάστε ολόκληρο τον φάκελο από το παρακάτω σενάριο με ένα πέρασμα και συνεχίστε να δουλεύετε με ελαφριά αρχεία .md αντί για ογκώδη PDF.

Αποθηκεύστε αυτό το σενάριο ως scripts/docs-to-md.sh στη ρίζα του έργου:

#!/bin/bash
# docs-to-md.sh - converts all documents in a folder to Markdown using MarkItDown
# Usage: bash docs-to-md.sh ./documents

set -e

INPUT_DIR="${1:-./documents}"
OUTPUT_DIR="${INPUT_DIR}/_md"

mkdir -p "$OUTPUT_DIR"

echo "Scanning $INPUT_DIR..."

for file in "$INPUT_DIR"/*.{pdf,docx,pptx,xlsx}; do
  [ -f "$file" ] || continue

  basename=$(basename "$file")
  name="${basename%.*}"
  output="$OUTPUT_DIR/${name}.md"

  if [ -f "$output" ] && [ "$output" -nt "$file" ]; then
    echo "Skipping $basename (already converted)"
    continue
  fi

  echo "Converting $basename..."
  markitdown "$file" > "$output"
done

echo "Done. Results are in $OUTPUT_DIR"

Κάντε το εκτελέσιμο:

chmod +x scripts/docs-to-md.sh

Εκτελέστε το:

bash scripts/docs-to-md.sh ./reports

Μετά την εκτέλεση, το ./reports/_md/ περιέχει εκδόσεις .md όλων των εγγράφων. Εισαγάγετέ τες στο Claude Code με το @reports/_md/ και δουλέψτε με το συμπυκνωμένο κείμενο αντί για PDF.

Το σενάριο παραλείπει αυτόματα αρχεία που έχουν ήδη μετατραπεί (αν το αρχείο .md είναι νεότερο από την πηγή) — η επανεκτέλεσή του είναι φθηνή και δεν επανυπολογίζει τα πάντα.

Αδρανειακή συμπεριφορά και αυξητική μετατροπή

Αν θέλετε το σενάριο να εντοπίζει PDF που έχουν αλλάξει (έχουν αποθηκευτεί ξανά με το ίδιο όνομα), προσθέστε έναν έλεγχο κατακερματισμού περιεχομένου:

hash=$(shasum -a 256 "$file" | cut -d' ' -f1)
hash_file="$OUTPUT_DIR/.${name}.sha256"

if [ -f "$hash_file" ] && [ "$(cat "$hash_file")" = "$hash" ]; then
  echo "Skipping $basename (hash matches)"
  continue
fi

markitdown "$file" > "$output"
echo "$hash" > "$hash_file"

Αυτή η εκδοχή μετατρέπει ξανά ένα αρχείο μόνο αν έχει αλλάξει το περιεχόμενό του.

Πότε είναι ακόμη καλύτερο ένα PDF στο Claude από το Markdown;

Κύριο συμπέρασμα

Η μετατροπή σε Markdown χάνει τρία πράγματα: οπτικά στοιχεία (διαγράμματα, γραφήματα, σχέδια), σύνθετους πίνακες με συγχωνευμένα κελιά και λεζάντες, καθώς και την πλήρη μορφοποίηση του εγγράφου ως τεκμηρίου (για παράδειγμα, μιας σύμβασης που πρέπει να παραπέμψετε ανά σελίδα). Αν αυτά έχουν σημασία για την εργασία, κρατήστε το PDF, ενεργοποιήστε την οπτική ανάλυση και πληρώστε συνειδητά το οπτικό κόστος.

Τρεις περιπτώσεις όπου η μετατροπή σε Markdown δεν επαρκεί:

1. Οπτική ανάλυση διαγραμμάτων και γραφημάτων

Αν το Claude πρέπει να «διαβάσει» ένα γράφημα — μια καμπύλη τιμών, ένα διάγραμμα διαδικασίας ή ένα διάγραμμα αρχιτεκτονικής — αυτές οι πληροφορίες δεν υπάρχουν στο Markdown. Το Markdown διατηρεί μόνο τις λεζάντες των σχημάτων· το ίδιο το σχήμα χάνεται.

Λύση: ανεβάστε το PDF και ενεργοποιήστε ρητά την οπτική λειτουργία. Στο Claude API, η σημαία λειτουργεί αυτόματα· στο AWS Bedrock, χρειάζεστε τη σημαία citations.

Το Claude αναλύει τόσο το κείμενο όσο και τις εικόνες για να κατανοήσει καλύτερα το έγγραφο.

— Anthropic, https://platform.claude.com/docs/en/docs/build-with-claude/pdf-support

2. Σύνθετοι πίνακες με συγχωνευμένα κελιά

Οι πίνακες Markdown είναι επίπεδοι. Αν το PDF έχει πίνακα με συγχωνευμένα κελιά, πολυεπίπεδες κεφαλίδες ή ενσωματωμένους υποπίνακες, ο μετατροπέας είτε θα τον ισοπεδώσει είτε θα χάσει τις μεταξύ τους σχέσεις.

Λύση: χρησιμοποιήστε απευθείας το PDF, χρησιμοποιήστε το Docling (χειρίζεται καλύτερα τους σύνθετους πίνακες) ή μορφοποιήστε τον χειροκίνητα μετά τη μετατροπή.

3. Έγγραφα ως τεκμήρια με παραπομπές σε σελίδες

Για νομικά έγγραφα, συμβάσεις και πρακτικά, έχει σημασία να μπορείτε να παραπέμψετε στη «σελίδα 7, παράγραφος 3». Οι αριθμοί σελίδων χάνονται στο Markdown.

Λύση: PDF + Files API + προσωρινή αποθήκευση προτροπών. Ανεβάστε το μία φορά και έπειτα αναφερθείτε σε αυτό μέσω του file_id· το Claude βλέπει τη σελιδοποίηση και μπορεί να παραπέμπει σε συγκεκριμένες σελίδες.

Σύντομα έγγραφα

Αν ένα PDF έχει λιγότερες από 2 σελίδες και το χρησιμοποιείτε μία φορά, η μετατροπή δεν αξίζει τον κόπο. 5.000 tokens για PDF έναντι 800 για Markdown δεν συνιστούν αρκετή εξοικονόμηση ώστε να δικαιολογούν την εγκατάσταση του MarkItDown.

Το σημείο ισοσκέλισης είναι περίπου 5+ σελίδες ή 2+ χρήσεις του ίδιου εγγράφου. Κάτω από αυτό, ανεβάστε απευθείας το PDF· πάνω από αυτό, μετατρέψτε το.

Ποια είναι τα 5 συνηθέστερα λάθη που κάνουν οι άνθρωποι με PDF στο Claude;

Κύριο συμπέρασμα

Οι βασικές παγίδες: ανεβάζετε ξανά το ίδιο PDF σε διαφορετικές συνομιλίες αντί να το μετατρέψετε μία φορά, δεν χρησιμοποιείτε προσωρινή αποθήκευση προτροπών για επαναλαμβανόμενα αιτήματα, χρησιμοποιείτε στιγμιότυπα οθόνης αντί για κείμενο, παραλείπετε το OCR σε σαρωμένα PDF και αγνοείτε το όριο των 100 σελίδων για μοντέλα με πλαίσιο συμφραζομένων 200K. Κάθε λάθος σπαταλά δεκάδες χιλιάδες tokens χωρίς λόγο.

1. Ανεβάζετε το ίδιο PDF σε νέα συνομιλία κάθε φορά

Το Claude Pro έχει όριο μηνυμάτων ανά 5 ώρες — μία αναφορά 50 σελίδων μπορεί να το εξαντλήσει ολόκληρο πριν κάνετε δεύτερη ερώτηση.

Υπάρχει μια απλή αρχή γι’ αυτό: μία εργασία — μία συνομιλία. Όταν η AI αρχίζει να καταναλώνει υπερβολικά πολλά tokens, σημαίνει ότι στριμώχνετε τα πάντα σε μία συνομιλία και επαναφέρετε το PDF ξανά και ξανά. Κρατήστε μία μικροεργασία σε κάθε παράθυρο. Μετατρέψτε το έγγραφο σε Markdown μία φορά και έπειτα προσθέστε το αρχείο .md σε κάθε νέο παράθυρο μαζί με το έργο. Ο κύκλος του παραθύρου συμφραζομένων δεν θα γίνει κίτρινος.

Λύση: είτε μετατρέψτε το μία φορά σε Markdown είτε χρησιμοποιήστε το Files API με file_id και προσωρινή αποθήκευση προτροπών.

2. Στιγμιότυπο οθόνης αντί για κείμενο

Ένα τυπικό παράδειγμα: κάποιος θέλει να δείξει στο Claude ένα απόσπασμα κώδικα ή έναν πίνακα, τραβά στιγμιότυπο ολόκληρης της οθόνης 1920×1080 και αναρωτιέται γιατί εξαντλήθηκε το όριο μετά από 5 αιτήματα.

Ένα στιγμιότυπο οθόνης 1000×1000 pixel κοστίζει ~1.300 tokens. Το ίδιο κείμενο, αν αντιγραφεί χειροκίνητα, κοστίζει 50–100 tokens. Η διαφορά είναι 13–26 φορές.

Λύση: περικόψτε τα στιγμιότυπα στενά (μόνο στο σημαντικό σημείο) ή, ακόμη καλύτερα, αντιγράψτε απευθείας το κείμενο.

3. Σαρωμένο PDF χωρίς OCR

Το MarkItDown δεν κάνει OCR. Αν μετατρέψετε μια σάρωση, το αποτέλεσμα είναι ένα κενό αρχείο .md (ή 3 γραμμές θορύβου).

Λύση: για σαρώσεις, χρησιμοποιήστε PyMuPDF4LLM (με το ενσωματωμένο έξυπνο OCR) ή Docling.

4. Αγνοείτε το όριο των 100 σελίδων

Η τεκμηρίωση της Anthropic αναφέρει όριο 600 σελίδων ανά αίτημα — αλλά στην πράξη, το όριο για μοντέλα με πλαίσιο συμφραζομένων 200K (Sonnet 4.x, Opus 4.x) είναι 100 σελίδες. Το όριο των 600 σελίδων προορίζεται για παλαιότερα μοντέλα ή ειδικά επίπεδα.

Αν ανεβάσετε μια αναφορά 150 σελίδων στο Sonnet 4.6, θα λάβετε σφάλμα ή, ακόμη χειρότερα, το Claude θα επεξεργαστεί μόνο τις πρώτες 100 σελίδες και θα ενεργήσει σαν να διάβασε ολόκληρο το έγγραφο.

Λύση: χωρίστε τα μεγάλα PDF σε μέρη πριν από τη μεταφόρτωση. Ή μετατρέψτε τα σε Markdown — δεν υπάρχει όριο σελίδων, μόνο όριο tokens.

5. Δεν χρησιμοποιείτε προσωρινή αποθήκευση προτροπών για επαναλαμβανόμενα αιτήματα

Αν εργάζεστε με το ίδιο έγγραφο μέσω API, τυλίξτε το σε cache_control: ephemeral. Οι επαναλαμβανόμενες κλήσεις εντός 5 λεπτών κοστίζουν το 10% της αρχικής τιμής. Ένα αίτημα κοστίζει περισσότερο· τα υπόλοιπα έχουν έκπτωση 90%.

Λύση: ενεργοποιήστε την προσωρινή αποθήκευση προτροπών από προεπιλογή για οτιδήποτε ανεβάζετε περισσότερες από μία φορές.

Τι ακολουθεί: μηχανική πλαισίου συμφραζομένων

Κύριο συμπέρασμα

Η μετατροπή PDF σε Markdown είναι μία τεχνική μηχανικής πλαισίου συμφραζομένων, ένας νέος γραμματισμός για την εργασία με AI. Μια προτροπή είναι μια ερώτηση. Τα συμφραζόμενα είναι όλα όσα βλέπει το Claude πριν και γύρω από την ερώτηση: η προτροπή συστήματος, το CLAUDE.md, τα αρχεία, οι διακομιστές MCP και το ιστορικό συνεδρίας. Όσο καθαρότερα είναι τα συμφραζόμενα, τόσο ακριβέστερη είναι η απάντηση και τόσο λιγότερο κοστίζει. Διαβάστε την πλήρη ανάλυση στον οδηγό «Context Engineering in 2026».

Η μετατροπή PDF σε Markdown είναι ένας τρόπος εξοικονόμησης tokens. Από μόνη της, δεν κάνει τις απαντήσεις του Claude πιο ακριβείς. Η ακρίβεια προκύπτει από τη μηχανική πλαισίου συμφραζομένων — την πρακτική του να επιλέγετε τι εισάγετε στο πλαίσιο συμφραζομένων του μοντέλου πριν κάνετε μια ερώτηση.

Αν το CLAUDE.md σας έχει 800 γραμμές, το έργο σας έχει 10 περιττούς διακομιστές MCP και εισάγετε ένα PDF 100 σελίδων, η μετατροπή σε Markdown θα αποτρέψει μία διαρροή, αλλά οι άλλες τρεις θα παραμείνουν. Γι’ αυτό αυτοί οι οδηγοί καλύπτουν:

Συνεχίστε να εξερευνάτε το Ailoot στο ailoot.ai.

Περισσότερες λεπτομέρειες

Ερωτήσεις και απαντήσεις: PDF στο Claude Code: μετατροπή, tokens και διατήρηση της δομής

Πόσα tokens Markdown χρησιμοποιεί το παράδειγμα 15 σελίδων και τεσσάρων συνομιλιών;

Με την παραδοχή του άρθρου 300 tokens ανά μετατραπείσα σελίδα, το σύνολο είναι 15 × 300 × 4 = 18,000 tokens εισόδου. Είναι ενδεικτική εκτίμηση· μετρήστε tokens του μετατραπέντος εγγράφου για το δικό σας αρχείο.

Μια μετατροπή κειμένου αρκεί για κάθε PDF;

Όχι. Συγκρίνετε το μετατραπέν Markdown με PDF, ειδικά πίνακες, σειρά σελίδων και περιεχόμενο που εξαρτάται από εικόνες. Συγκρίνετε χρήση tokens μόνο αφού επιβεβαιώσετε ότι διατηρήθηκε η πληροφορία που χρειάζεται η εργασία.

Όλα τα άρθρα