Come convertire file PDF e Word in testo per l’IA: MarkItDown di Microsoft

Altre istruzioni sono disponibili nella documentazione di Ailoot.

Che cos'è MarkItDown e a cosa serve?#

Invii a un'IA un contratto, un rapporto o un'esportazione contabile e ottieni una risposta che non ha nulla a che fare con il documento. Di solito la causa non è il modello. Il file contiene un formato: Word è un archivio con markup, Excel è un foglio di calcolo con collegamenti tra le celle e PDF è un insieme di caratteri con coordinate sulla pagina. Il modello lavora con il testo e qualcuno deve estrarlo.

È questo che fa MarkItDown. Il repository si trova su github.com/microsoft/markitdown, con licenza MIT, quindi puoi usarlo senza restrizioni. Al 18 agosto 2026, ha 174,412 stelle e 12,756 fork; l'ultima release, 0.1.7, è uscita il 29 luglio. Il progetto è attivo, anche se il suo orientamento è passato dallo sviluppo alla manutenzione: ha 481 pull request aperte, contro 183 unite nell'intera storia del progetto.

Gli sviluppatori ne descrivono così lo scopo:

La frase successiva della descrizione spiega metà delle lamentele che si sentono sullo strumento:

Il risultato è materiale grezzo per un modello. Non sarà un documento bello da vedere, e il progetto lo dice chiaramente fin dalla prima sezione.

La descrizione spiega direttamente perché viene usato Markdown: i modelli più avanzati «parlano» già questo markup e lo includono nelle risposte senza che venga richiesto, perché ne hanno visti enormi volumi durante l'addestramento. Il markup è anche compatto: tre cancelleti per un titolo invece di una dozzina di righe di metadati.

In cosa MarkItDown è diverso da un convertitore normale?#

La differenza si vede chiaramente in un esempio. Prendi una cartella con venti PDF e prova a elaborarli con pandoc. Non funzionerà: pandoc può produrre PDF come output, ma non può leggerli come input. Ed è proprio questa la situazione più comune: «Ho una pila di documenti; passali al modello».

Gli autori di MarkItDown lo confrontano con textract, una libreria che estrae semplicemente il testo da qualsiasi fonte. La differenza è che MarkItDown cerca di preservare la struttura: titoli, elenchi, tabelle e collegamenti.

La conclusione pratica è semplice. Se devi convertire un articolo in un layout da pubblicare, usa pandoc. Se vuoi che un'IA comprenda venti contratti, usa MarkItDown.

Come si installa MarkItDown evitando che venga installata la prima release?#

Prima il comando giusto; poi, perché è quello giusto.

1. Controlla la versione di Python

   Python 3.12 è la scelta più affidabile: in ogni ambiente testato su questa versione si installa la release più recente di MarkItDown. Il comando python3 --version mostra la versione disponibile. Sui Mac Intel o sui Mac con una versione meno recente di macOS, Python 3.13 e 3.14 possono provocare un downgrade silenzioso; Python 3.15 non è ancora supportato, come spiegato più avanti.

2. Installa specificando i formati

   Esegui pip install 'markitdown[pdf,docx,xlsx,pptx]'. Le virgolette sono necessarie, altrimenti la shell interpreterà le parentesi quadre. Su un Mac Intel, aggiungi il flag --prefer-binary dopo install.

3. Controlla subito che l'installazione sia riuscita

   Esegui markitdown --version. La risposta dovrebbe essere markitdown 0.1.8 o successiva. Un numero inferiore indica che l'installazione ha eseguito un downgrade; in questa sezione viene spiegato il motivo.

pip install 'markitdown[pdf,docx,xlsx,pptx]'
markitdown --version

La descrizione del progetto indica pip install 'markitdown[all]' come comando principale, per installare tutto in una volta. Il 28 settembre 2026, una settimana dopo l'uscita della versione 0.1.8, sono state eseguite quattro varianti in ambienti puliti su un Mac con Apple Silicon e Python 3.14.6 e 3.12.12:

Tutte e otto le installazioni si sono concluse con «Successfully installed» e markitdown --version ha restituito 0.1.8 in ogni caso. Ad agosto, quando la release più recente era la 0.1.7, il terzo comando su Python 3.14 installava la 0.0.2, pubblicata l'8 marzo 2025, la seconda release nella storia del progetto. Ora ci sono undici release stabili, dalla 0.0.1 alla 0.1.8, e ventisei incluse le pre-release.

La causa era la catena di dipendenze. Nella versione 0.1.7, l'extra [all] include una libreria per i sottotitoli di YouTube appartenente a una specifica serie di release, tutte dichiarate incompatibili con Python 3.14. Il programma d'installazione le rifiuta e, poiché nessuna versione è bloccata, risale tra le versioni di MarkItDown finché non ne trova una installabile. Trova la 0.0.2 e la installa, mettendo sulla tua macchina una release vecchia di un anno e mezzo. Nella versione 0.1.8, il requisito della libreria per i sottotitoli è stato portato a una serie compatibile con la 3.14 e il downgrade si è fermato.

Il meccanismo è ancora presente. Se il programma d'installazione non riesce a trovare uno dei componenti richiesti per il tuo sistema, torna silenziosamente alla 0.0.2 nello stesso modo. Nelle versioni recenti, il componente in questione è il motore onnxruntime usato dal rilevatore di tipo di file. Su Mac, viene compilato così: per Python 3.12, macOS 11 e successivi; per la 3.13, macOS 13; per la 3.14, solo Apple Silicon con macOS 14 o successivo. Se il tuo Mac non soddisfa questi requisiti, anche il comando essenziale pip install markitdown installa la 0.0.2. Un test su un Mac Intel con Python 3.14 tramite Rosetta ha prodotto esattamente questo risultato: «Successfully installed», nessun avviso e la versione 0.0.2 installata.

I Mac Intel hanno un'altra complicazione. Da giugno 2026, la libreria cryptography richiesta per leggere i PDF viene rilasciata senza una versione precompilata per questo processore, quindi il programma d'installazione cerca di compilarla dai sorgenti. Aggiungi al comando il flag --prefer-binary e verrà usata la versione precedente con un pacchetto precompilato. Nei test con Python 3.13 su Intel, così è stata installata la versione 0.1.8 e il PDF si è aperto. Il flag installa cryptography 48.0.1, che presenta tre vulnerabilità note: nella decifratura PKCS#7 e nella verifica della catena di certificati. MarkItDown la usa solo per decifrare PDF protetti e la lettura dei documenti non raggiunge quelle parti.

Con Python 3.15, il downgrade si verifica per due motivi. La versione 0.1.8 dichiara il supporto solo dalla 3.10 alla 3.14 e non esiste ancora un motore per la 3.15. La risoluzione delle dipendenze del programma d'installazione per la 3.15 lo conferma: sia il comando essenziale sia quello con i formati installano la stessa versione 0.0.2.

Un avviso di downgrade si presenta così, una riga per ogni extra specificato nel comando:

WARNING: markitdown 0.0.2 does not provide the extra 'all'

La riga si perde tra decine di righe di download e non dice nulla sulla versione sostitutiva. Con un comando essenziale senza extra, non compare nemmeno un avviso. Il rapporto finale è rassicurante: «Successfully installed».

Installare senza extra non è una soluzione. Il pacchetto essenziale si installa, ma non può aprire i PDF:

PdfConverter recognized the input as a potential .pdf file, but the
dependencies needed to read .pdf files have not been installed. To resolve
this error, include the optional dependency [pdf] or [all] when installing
MarkItDown. For example:

* pip install 'markitdown[pdf]'
* pip install 'markitdown[all]'

È lo stesso strumento a consigliare [all] e, con la versione 0.1.8, quel consiglio funziona di nuovo su Python 3.14 e 3.12. È comunque meglio specificare i formati per nome: [all] aggiunge una quindicina di pacchetti e circa 55 megabyte, compresa una libreria Azure in pre-release e proprio la catena di dipendenze YouTube che aveva già interrotto l'installazione una volta.

Il programma d'installazione gestisce da solo la pre-release di Azure. Normalmente pip ignora le pre-release, ma in questo caso il requisito indica esplicitamente una pre-release, quindi la installa. Sono state testate quattro versioni di pip, dalla 23.2 alla 26.2, su Python 3.12; tutte selezionano la versione 0.1.8.

Ad agosto, reinstallando in un altro ambiente pulito, si è ottenuto lo stesso risultato: 0.0.2 e la parola «Successfully».

È utile conoscere in anticipo alcuni dettagli pratici.

È piuttosto pesante: un'installazione essenziale occupa 143 megabyte; con quattro formati, 303. Il componente più pesante, 81 megabyte, è il rilevatore di tipo di file, incluso persino nell'installazione di base. Su un laptop non è un problema, ma lo è per una funzione cloud soggetta a un limite di dimensione.

Non contare sui mirror come soluzione di riserva. Un mirror testato forniva un indice e conteneva i file di MarkItDown, ma mancava una dipendenza richiesta, quindi l'installazione non è riuscita né con Python 3.14 né con 3.12.

L'installazione è un problema secondario rispetto a quello principale. Molto più spesso, un'IA produce risultati senza senso perché nel suo contesto entra la cosa sbagliata, o una rappresentazione sbagliata. La capacità di decidere cosa fornire a un modello prima di assegnargli un compito si chiama context engineering, e la preparazione dei documenti ne fa parte.

Come si converte il primo documento in testo?#

L'opzione più breve:

markitdown dogovor.docx

Il testo viene stampato nel terminale. Per salvarlo in un file, ci sono due modi:

markitdown dogovor.docx -o dogovor.md
markitdown dogovor.docx > dogovor.md

Su Mac e Linux la differenza è trascurabile, ma su Windows è importante: la redirezione con > può mandare in crash il programma quando l'output contiene testo cirillico.

Puoi passare un file come flusso; in quel caso è utile specificare l'estensione:

cat dogovor.docx | markitdown -x docx

Ecco i flag principali dell'help della versione 0.1.8:

Lo stesso help elenca altri tre flag utili, ciascuno testato: --list-plugins mostra i plugin installati, -p li abilita per una determinata esecuzione e --keep-data-uris mantiene nell'output le immagini incorporate nel documento, che per impostazione predefinita vengono ritagliate. Gli altri flag configurano i servizi cloud di Microsoft.

Il wrapper Python richiede tre righe:

from markitdown import MarkItDown

md = MarkItDown()
print(md.convert("ostatki.xlsx").text_content)

La stessa chiamata accetta un URL. Una pagina semplice ha restituito testo pulito di 167 caratteri, incluso un titolo e un collegamento, senza il menu e il piè di pagina:

r = md.convert("https://example.com")

Quali formati riconosce MarkItDown e cosa significa davvero?#

Una tabella riassume ciò che viene dichiarato e cosa succede in pratica.

Tre elementi più nel dettaglio.

Immagini. La descrizione include la parola OCR, quindi ci si aspetta che il programma legga il testo in una foto. Non lo fa. Legge i metadati con un programma separato, exiftool e, se colleghi un modello di visione con una tua chiave, può inviargli l'immagine per farla descrivere.

Audio. La trascrizione del parlato è disponibile, ma la lingua non viene specificata e per impostazione predefinita il motore si aspetta l'inglese. Inoltre, viene contattato l'endpoint gratuito non ufficiale di Google, limitato a circa cinquanta richieste al giorno per chiave.

Archivi. Il programma decomprime i file ZIP ed esamina quelli al loro interno, concatenando i risultati. Se non riesce ad analizzare un file, l'errore viene intercettato e ignorato. Il file semplicemente non compare nel risultato e tu non lo saprai.

Cosa succede con i documenti che contengono testo cirillico?#

I file seguenti sono stati creati appositamente per il test; i loro dati sono inventati.

Il foglio Excel con l'inventario è stato convertito altrettanto bene, con il nome del foglio trasformato in un titolo:

## Stock
| Item | In stock | Reserved | Available |
| --- | --- | --- | --- |
| Coffee beans, kg | 420 | 38 | 382 |
| Loose-leaf tea, kg | 180 | 52 | 128 |

La presentazione è diventata testo, con i numeri delle diapositive riportati come annotazioni e i titoli delle diapositive trasformati in titoli. Anche qui il testo cirillico è intatto. L'affermazione generica «MarkItDown non capisce il cirillico» è falsa.

Vediamo ora i tre casi in cui qualcosa si rompe.

CSV con punto e virgola. Per fare un confronto, sono stati elaborati due export identici di fatture. Quello con le virgole ha prodotto una tabella corretta a quattro colonne. Con il punto e virgola, l'intera riga finisce in una sola cella.

L'intera riga è finita in una sola cella. La codifica è stata riconosciuta correttamente e non si è verificato alcun errore; il flag -c non aiuta. Il modello riceverà questa tabella e non capirà quale valore sia l'importo e quale lo stato. Esporta di nuovo il file specificando la virgola come delimitatore e la codifica corretta, conservando l’originale invariato. Non sostituire globalmente i punti e virgola: separatori nel testo tra virgolette e virgole decimali possono appartenere ai valori. Se non puoi riesportare, leggi l’originale con il suo delimitatore effettivo e scrivi un nuovo CSV con uno strumento che conservi virgolette e valori delle celle. Prima dell’analisi confronta numero di colonne, righe e totali di controllo con l’esportazione di origine.

Formattazione della valuta in Excel. Il simbolo di valuta è memorizzato nelle impostazioni di visualizzazione della cella e non fa parte del valore. I responsabili del progetto hanno confermato la causa. Per un listino prezzi o una fattura, questo è importante: il modello vedrà i numeri senza sapere a quale valuta si riferiscono.

Console di Windows. Con file che contengono caratteri non latini, il programma può andare in crash.

La traccia dell'errore mostra la codifica cp1251, cioè la console di Windows. Il documento viene analizzato correttamente; è la stampa del risultato nella finestra del terminale a non funzionare. Ecco quindi due soluzioni alternative:

markitdown dogovor.docx -o dogovor.md
$env:PYTHONUTF8 = "1"; markitdown dogovor.docx > dogovor.md

La prima evita del tutto la console; la seconda fa scrivere Python in UTF-8. Sono state proposte correzioni al problema nello strumento stesso almeno sei volte: alcune proposte sono state chiuse senza essere unite, mentre le altre sono ancora aperte. Quindi bisogna ricorrere a una soluzione alternativa.

Un quarto sintomo compare nei PDF: sequenze come (cid:1090) al posto delle lettere. Significa che il file usa una tabella dei font non standard e i caratteri non sono stati decodificati. Non ha senso elaborare un documento del genere con MarkItDown: serve un altro strumento.

Perché il risultato di un PDF è un pasticcio?#

Per il test, è stato elaborato un articolo scientifico a due colonne di 2.16 megabyte. Il codice di uscita era zero; dopo 0.9 secondi, l'output conteneva 88,000 caratteri, quasi tutti senza senso. Ottantottomila caratteri danno l'impressione che tutto abbia funzionato. Almeno finché non apri il file:

|     | Hybrid |          | OCR-LLM     |     | Framework  |
| --- | ------ | -------- | ----------- | --- | ---------- |
...
Informationextractionfromcopy-heavydoc-
5202 tcO 11  ]LC.sc[  1v83101.0152:viXra

Sono andate storte tre cose contemporaneamente. Il layout a due colonne è diventato un insieme di tabelle che non esistono nell'articolo. Le parole si sono unite senza spazi. L'ultima riga è una barra laterale verticale della pagina, estratta al contrario.

Poi è arrivata la parte divertente. L'articolo usato per il test si è rivelato essere proprio il lavoro che misurava MarkItDown e lo confrontava con altri strumenti. Lo strumento ha trasformato così il paragrafo che riportava le sue stesse misurazioni:

cues. This name-matching error could be miti-  OCRpreprocessingoverhead(0.056s),whileDo-
gatedthroughpromptengineeringtoprovidemore  clingandMinerUadoptmorecomputationallyin-
explicit matching instructions or fine-tuning the  tensive strategies with OCR latencies of approxi-

Le colonne sinistra e destra vengono unite riga per riga. Un modello che ricevesse questo testo leggerebbe metà frase di un paragrafo e metà di un altro.

La causa è tecnica e semplice. Word memorizza esplicitamente «questo è un titolo» e «questa è una cella di tabella». Un PDF memorizza «questo è un carattere» e «queste sono le sue coordinate sulla pagina». Ricostruire la struttura a partire dalle coordinate è un compito distinto e difficile, e MarkItDown ci prova a malapena. Il codice sorgente per l'analisi dei PDF non rileva i titoli: se una pagina non viene riconosciuta come modulo o tabella, l'intero documento passa attraverso un'estrazione di testo di base.

Gli utenti lo segnalano regolarmente nel repository del progetto, anche per articoli scientifici e tabelle.

Lo strumento non trova nemmeno un titolo nei PDF, esattamente come mostra il codice sorgente.

Online circola il dato «MarkItDown raggiunge una precisione dell'82%» senza alcuna metodologia. Cercare la fonte originale non porta a nulla: la catena di link termina in una pagina che non si carica. Non può essere considerato una misurazione.

Cosa succede con un contratto scansionato?#

Questo comportamento è più pericoloso degli altri perché non sembra un errore.

Per il test, è stato creato da un'immagine contenente testo un PDF, proprio come quello che si ottiene fotografando o scansionando un contratto. L'esecuzione è stata ripetuta per escludere il caso fortuito:

Zero caratteri e zero errori, due volte di seguito. Un codice di uscita zero significa «tutto è andato bene» e qualsiasi script che verifichi il successo tramite il codice di uscita considererà il documento elaborato. Poi l'output vuoto viene passato al modello, il modello non vede nulla e comincia a inventare una risposta dal nulla.

Ci sono due soluzioni alternative, entrambe a pagamento. La prima è il flag -d, che invia il documento al servizio cloud di riconoscimento di Microsoft; il testo di aiuto del flag specifica esplicitamente che è necessario un endpoint di servizio valido. La seconda è un pacchetto aggiuntivo separato che invia le pagine a un modello di visione usando la tua chiave, quindi paghi il fornitore del modello per ogni pagina. Da aprile 2026, in una discussione aperta sul secondo metodo è stato segnalato che viene elaborata solo la prima pagina di una scansione multipagina.

Puoi anche eseguire un modello di riconoscimento sulla tua macchina, ma è un progetto a parte.

Per un singolo documento, è più facile aprirlo e copiare il testo manualmente. Per un flusso continuo di scansioni, serve uno strumento con riconoscimento integrato.

Si può semplicemente caricare il file in un convertitore online?#

«MarkItDown online» è uno dei suggerimenti di ricerca più comuni e ci sono siti che lo offrono. Lo strumento originale di Microsoft non ha alcun sito web: è disponibile solo come programma da installare autonomamente. Qualsiasi prodotto con un nome simile che si apre nel browser è stato creato da qualcun altro.

Puoi controllare un servizio del genere in un minuto: apri gli strumenti per sviluppatori nella scheda delle richieste di rete, carica un file innocuo e verifica se viene inviato a un server. Se sì, l'affermazione sull'elaborazione nel browser è falsa, per quanto la FAQ la presenti con sicurezza.

Ecco perché MarkItDown è apprezzato nei contesti in cui i documenti non possono uscire dall'organizzazione. In una discussione, una persona ha descritto la propria situazione: sul laptop aziendale erano vietati programmi arbitrari, ma erano consentite le librerie Python, e l'utilità locale si è rivelata l'unica opzione disponibile.

Quanto fa risparmiare davvero MarkItDown?#

Un file Office è strutturato come un archivio che contiene markup. Se decomprimi i tre file di test e confronti le dimensioni della parte che contiene il testo con quelle dell'output, ottieni questi valori:

I file sono piccoli; le proporzioni cambieranno con quelli più grandi e non esiste un'unica cifra di risparmio. Quando gli articoli di confronto riportano numeri tondi, chiedi quale metodologia hanno usato.

Anche gli sviluppatori parlano del risparmio: la descrizione del progetto afferma esplicitamente che le convenzioni di Markdown sono molto economiche in termini di caratteri. È vero, ma non dovrebbe essere il principale argomento di vendita. La differenza tra «il modello ha ricevuto tremila caratteri invece di quindicimila» e «il modello ha ricevuto una struttura chiara invece di un miscuglio» è di un altro ordine di grandezza. La prima fa risparmiare denaro; la seconda determina se la risposta avrà senso.

Se ti interessa l'uso del contesto, ne parliamo a parte: Dove finiscono i token in Claude e quanti ne sono inclusi in ogni piano.

Come collegare MarkItDown all’agente AI Claude Code tramite MCP?#

MCP è un modo per dare a un'IA uno strumento esterno che può usare autonomamente. Per una panoramica del meccanismo e di altri server, consulta la recensione dei server MCP per Claude Code.

Il server MarkItDown espone un solo strumento: convertire un documento in testo. Accetta un percorso di file locale, l'URL di una pagina o dati incorporati direttamente nella richiesta.

Si collega a Claude Code con un solo comando, bloccando la versione del server. Serve il gestore di pacchetti uv:

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

La risposta al secondo comando dovrebbe mostrare «Connected» per markitdown. Al primo avvio vengono scaricati circa settanta pacchetti e ci vuole fino a un minuto; poi il server si avvia in uno o un secondo e mezzo.

Ecco le limitazioni, verificate manualmente.

La build 0.0.1a7 è stata rilasciata il 14 settembre 2026. Prima di allora, per oltre un anno il server era fermo alla versione 0.0.1a4 di maggio 2025. Il numero di versione più recente indica ancora una pre-release.

Non si installa su tutti i sistemi con una versione recente di Python. Il motore onnxruntime da cui dipende è disponibile per Python 3.14 su Mac solo per Apple Silicon con macOS 14 o successivo, quindi l'installazione non riesce sui Mac Intel e su macOS 13 o precedente con Python 3.14. Su un Mac con Apple Silicon, il server è stato eseguito con Python 3.14, 3.13 e 3.12 e si è installato in tutti e tre i casi. Il comando usa UV_PYTHON=3.12: sono disponibili pacchetti precompilati per la 3.12 su Windows, Linux e Mac con Apple Silicon, e se non hai questa versione di Python uv la scaricherà. Anche qui c'è una limitazione per i Mac Intel: uv compilerà la libreria cryptography dai sorgenti perché da giugno 2026 non esistono pacchetti precompilati per Intel. L'installazione richiede più tempo e potrebbe non riuscire.

La versione di MarkItDown installata internamente dipende dalla versione di uv. A partire da MarkItDown 0.1.6, l'extra [all] richiede una libreria Azure in pre-release: uv 0.12 e successivi la installano insieme all'ultima versione di MarkItDown, la 0.1.8, mentre le versioni meno recenti di uv fanno il downgrade alla 0.1.5. Controlla la versione di uv con uv --version.

Due elementi vengono inviati fuori dalla macchina. Il primo è la telemetria: su Mac e Linux, il motore onnxruntime all'interno del server la invia a Microsoft per impostazione predefinita. La variabile ORT_DISABLE_TELEMETRY=1 nel comando la disabilita. Nel test, senza questa variabile il server si è collegato agli endpoint di telemetria di Microsoft. Con la variabile impostata, durante l'elaborazione dei file dal disco non ci sono state connessioni.

Il secondo elemento è l'audio. Il server invia file WAV, MP3, M4A e MP4 al servizio di riconoscimento vocale di Google per la trascrizione tramite HTTP normale, senza crittografia. È meglio non inviargli registrazioni di conversazioni con i clienti.

Un documento grande non riuscirà a passare. Una discussione aperta descrive una risposta del server da 51,000 token che ha raggiunto un limite di 25,000 token; lo strumento non suddivide i file in parti.

E poi c'è la sicurezza. La documentazione del pacchetto dichiara chiaramente:

In altre parole, un agente dotato di questo strumento può leggere tutto ciò che puoi leggere tu. È accettabile lavorare sulla propria macchina. Non devi esporre il server pubblicamente né affidarlo a un agente non attendibile.

Per il lavoro normale, è più facile richiamare il programma con un comando e mettere il testo risultante nel progetto. Il file si troverà così accanto agli altri materiali, dove il modello può consultarlo autonomamente.

Quando è più corretto usare un altro strumento?#

Un confronto basato sulle attività; le stelle di GitHub non c'entrano:

C'è un dettaglio su Marker che gli articoli di confronto omettono. Da luglio 2026, il codice è distribuito con una licenza permissiva, mentre i pesi del modello hanno una licenza separata con una soglia: l'utilizzo è gratuito se l'azienda non ha superato cinque milioni di dollari di ricavi e la stessa cifra di finanziamenti raccolti nell'anno precedente. Un'altra clausola vieta l'utilizzo a chiunque sviluppi un prodotto concorrente. Per la maggior parte dei lettori non è rilevante, ma un'azienda in crescita dovrebbe leggere la licenza prima di adottarlo.

Ne deriva un flusso di lavoro pratico in quattro passaggi:

1. Elabora tutto con MarkItDown: è gratuito e immediato.
2. Apri il risultato e controllane le dimensioni.
3. Se il testo ha senso, il compito è concluso: non serve altro.
4. Se l'output è un pasticcio o è vuoto, elabora quel file specifico con uno strumento più potente.

In questo modo, paghi in tempo e complessità solo per i documenti che ne hanno bisogno.

Come integrare MarkItDown nel flusso di lavoro?#

Anthropic usa MarkItDown nelle proprie skill già pronte per lavorare con i file Office e queste indicano chiaramente il limite da rispettare:

Nel testo si perdono i riferimenti alle celle e alle pagine, quindi non puoi usarlo per modificare il file di origine. Ecco tre scenari.

Un gruppo di documenti simili: verbali, fatture, moduli, domande. Mettili in una cartella ed elaborali con una riga:

for f in dokumenty/*.docx; do markitdown "$f" -o "text/$(basename "$f" .docx).md"; done

Poi fornisci al modello la cartella dei file di testo e chiedigli di compilare le informazioni pertinenti in una tabella. Funziona con i file digitali; le scansioni non riusciranno e potrai individuarle subito dalle dimensioni nulle.

Materiali di progetto di riferimento, come listini prezzi, modelli di contratto, norme e descrizioni di servizi. Convertiteli una volta in testo e metteteli accanto al progetto. Il modello potrà leggerli a ogni richiesta, così non dovrai allegare i file alla conversazione ogni volta. L'articolo sul caricamento di file in Claude spiega in cosa differisce dal caricamento di un file in chat.

Un'esportazione da un sistema contabile. Un export Excel di un software contabile o di un conto bancario diventa una tabella in un terzo di secondo e il modello può farci calcoli senza passaggi intermedi. Controlla che il CSV sia esportato o letto con delimitatore effettivo, virgolette e codifica corretti, e confronta righe, colonne e totali di controllo prima di passarlo al modello. Non normalizzare i separatori con una sostituzione testuale. Indica anche esplicitamente la valuta: un simbolo presente soltanto nella formattazione della cella Excel non sopravvive all’estrazione.

L'elaborazione di grandi PDF nel terminale non rientra in questo elenco. È un problema a parte, relativo all'uso del contesto, trattato nell'articolo sui PDF in Claude Code senza perdere token. Se stai configurando il tuo ambiente di lavoro, inizia da installare Claude Code.

Per iniziare subito, esegui pip install 'markitdown[pdf,docx,xlsx,pptx]', elabora il primo contratto Word che trovi e controlla le dimensioni del risultato. In mezzo minuto saprai se funziona con i tuoi file.

Quando sei pronto, scopri Ailoot.