# Documenti

Come funziona l'esportazione di Documenti, dal collegamento alla soluzione dei problemi.

## Collegare

Prema “collega” sulla scheda Documenti e scelga la cartella in cui si trovano i suoi documenti; viene letto tutto ciò che contiene, sottocartelle comprese. Il pannello si apre in `~/Documents` e può creare una nuova cartella. Poi prema “scegli la cartella” e scelga una cartella separata, come `~/Documents/converted`.

La cartella di esportazione non può essere la cartella dei documenti né una cartella al suo interno, e la cartella dei documenti non può trovarsi dentro la cartella di esportazione: l'app non le permette di scegliere né l'una né l'altra.

## Dove vanno i file

Ogni risultato si trova dove si trova il suo documento nella sua cartella, con la stessa struttura: `report.md`, e `report.html` accanto quando HTML è selezionato. Due documenti con lo stesso nome nella stessa cartella mantengono l'estensione nel nome del file: `report-pdf.md`, `report-docx.md`. Una cartella direttamente dentro la sua cartella Inizio, come `~/Documents`, riceve al suo interno una cartella `documents-export`; una più profonda viene usata così com'è.

## Cosa viene letto

| tipo | file |
| --- | --- |
| Word e testo | `.doc`, `.docx`, `.docm`, `.odt`, `.rtf` |
| Presentazioni | `.ppt`, `.pps`, `.pot`, `.pptx`, `.pptm`, `.ppsx`, `.ppsm`, `.odp` |
| Fogli di calcolo | `.xls`, `.xlsx`, `.xlsm`, `.xlsb`, `.ods`, `.csv` |
| PDF e libri | `.pdf`, `.epub` |

Restano fuori: i file di Pages, Numbers e Keynote (li esporti prima in Word, PowerPoint, Excel o PDF), i file nascosti, i file dentro i pacchetti e i link simbolici. Le viste filtrano l'elenco: Tutti, PDF, Word, Slide, Fogli, Libri e Scan.

## Pagine scansionate

Una pagina PDF senza testo viene letta dal riconoscimento del testo di Apple sul suo Mac; non viene caricato nulla. Una pagina che non riesce a leggere diventa `> page <n>: scanned page could not be read`. Il riconoscimento del testo funziona solo sui PDF.

## Markdown e HTML

Selezioni “Markdown”, “HTML” o entrambi sulla riga `formato`; almeno uno resta selezionato. Documenti è l'unica app che scrive entrambi in una sola sincronizzazione. L'HTML è semplice, senza stile. Il server MCP legge solo il Markdown.

## Il file

| chiave | contiene |
| --- | --- |
| `title` | il nome del file senza estensione |
| `source` | il percorso del documento dentro la sua cartella dei documenti |
| `format` | l'estensione originale |
| `pages` | il numero di pagine di un PDF |
| `scanned` | `true` quando il riconoscimento del testo ha letto le pagine |
| `modified` | quando il documento è cambiato l'ultima volta |

```markdown
---
title: "Quarterly report"
source: "Work/Quarterly report.pdf"
format: pdf
pages: 12
scanned: true
modified: 2026-08-30T17:02:11Z
---

# Quarterly report
```

## Gratis e sbloccato

I 10 documenti modificati più di recente tra quelli selezionati si convertono gratis, e i due formati di un documento contano una volta sola; gli altri richiedono lo sblocco una tantum ([prezzi](https://exporter.dev/pricing)).

## Sincronizzazione e risincronizzazione completa

Dopo il primo “sincronizza ora”, Exporter osserva la cartella finché è in esecuzione e converte ciò che è cambiato pochi secondi dopo il salvataggio. Un documento il cui Markdown è già più recente viene saltato senza essere aperto, così anche una cartella grande resta veloce. Il pulsante di conversione alla fine di una riga converte subito quel documento, selezionato o no. Il risultato di un documento eliminato esce alla sincronizzazione successiva.

“risincronizza tutto” chiede prima conferma, poi rimuove solo i file scritti da Exporter nella cartella di esportazione e converte di nuovo i suoi documenti.

## Problemi e soluzioni

- un triangolo rosso su una riga indica il motivo per cui il documento non è riuscito, come “questo documento è protetto da password” o “questo documento è danneggiato e manca una parte del suo contenuto”. Lo sistemi nell'app che l'ha creato, poi prema il pulsante di conversione alla fine della riga
- un lucchetto su una riga, “limite gratuito raggiunto · sblocca i documenti per convertire questo”: il documento è oltre i dieci gratuiti
- “impossibile aprire quella cartella”: la cartella dei documenti è stata spostata o la sua unità non è montata. Prema di nuovo “collega”
- manca un file di Pages, Numbers o Keynote: lo esporti in Word, PowerPoint, Excel o PDF, e il risultato viene convertito

## Related

- [Documents](https://exporter.dev/documents): Word, slides, sheets and PDFs to Markdown
- [Documents guides](https://exporter.dev/guides/documents): Documents Claude can read
- [Help](https://exporter.dev/docs/help): Problems and questions, with fixes

---

human version: https://exporter.dev/it/docs/documents
every page: https://exporter.dev/llms.txt
