# Guida agli strumenti JSON: documenti e dati in JSON e viceversa

> Questa guida spiega come gli strumenti JSON leggono e scrivono i file, il formato documento comune a PDF e Word in JSON e quale strumento scegliere.

- Pagina: https://acepdfmd.com/it/guides/json-guide/
- Aggiornato: 2026-09-21
- Disponibile su: https://acepdfmd.com (I file caricati vengono eliminati entro 60 minuti. Nessuna registrazione per un uso leggero.)
- Anche in 29 lingue: https://acepdfmd.com/<lang>/guides/json-guide/

## Perché JSON

JSON è il formato di dati che programmi, servizi web e modelli di IA leggono con più facilità: oggetti con campi con nome, elenchi, numeri, testo, true, false e null, nient'altro. Documenti e foglietti di calcolo non sono memorizzati in questo modo. Gli strumenti di questa famiglia colmano il divario in entrambe le direzioni: trasformano PDF, file Word, foglietti di calcolo, CSV, YAML e XML in JSON, e trasformano JSON di nuovo in file che le persone leggono, come PDF, Word, Excel, CSV e HTML.

Ogni strumento viene eseguito sui nostri server tramite una connessione sicura ed elimina il file caricato entro 60 minuti. Il testo può essere incollato direttamente invece di essere caricato come file.

## Quale strumento per quale attività

| Hai | Vuoi | Usa |
|---|---|---|
| Un PDF | Testo, tabelle e metadati come dati | [PDF in JSON](https://acepdfmd.com/it/tool/pdf-to-json/) |
| Un documento Word | Titoli, paragrafi, elenchi e tabelle come dati | [Word in JSON](https://acepdfmd.com/it/tool/word-to-json/) |
| Una cartella di lavoro Excel | Record, righe o colonne | [Excel in JSON](https://acepdfmd.com/it/tool/excel-to-json/) |
| Un file CSV o TSV | Un array JSON con valori tipizzati | [CSV in JSON](https://acepdfmd.com/it/tool/csv-to-json/) |
| Un file YAML | Gli stessi dati come JSON | [YAML in JSON](https://acepdfmd.com/it/tool/yaml-to-json/) |
| Un file XML | Oggetti, attributi e array | [XML in JSON](https://acepdfmd.com/it/tool/xml-to-json/) |
| JSON | Un PDF da leggere o stampare | [JSON in PDF](https://acepdfmd.com/it/tool/json-to-pdf/) |
| JSON | Una cartella di lavoro Excel | [JSON in Excel](https://acepdfmd.com/it/tool/json-to-excel/) |
| JSON | Un file CSV | [JSON in CSV](https://acepdfmd.com/it/tool/json-to-csv/) |
| JSON | Un documento Word modificabile | [JSON in Word](https://acepdfmd.com/it/tool/json-to-word/) |
| JSON | Una pagina web | [JSON in HTML](https://acepdfmd.com/it/tool/json-to-html/) |
| JSON | YAML per un file di configurazione | [JSON in YAML](https://acepdfmd.com/it/tool/json-to-yaml/) |
| JSON | XML per un altro sistema | [JSON in XML](https://acepdfmd.com/it/tool/json-to-xml/) |
| JSON disordinato o non valido | JSON pulito e valido | [Formattatore JSON](https://acepdfmd.com/it/tool/json-formatter/) |
| Due file JSON | Un elenco di ciò che è cambiato | [Confronta JSON](https://acepdfmd.com/it/tool/json-compare/) |

Markdown ha la sua coppia: [Markdown in JSON](https://acepdfmd.com/it/tool/markdown-to-json/) esporta un albero del documento e [JSON in Markdown](https://acepdfmd.com/it/tool/json-to-markdown/) trasforma JSON in una struttura a indice o in una tabella Markdown.

## Il formato documento

PDF in JSON e Word in JSON scrivono la stessa forma, così un unico codice gestisce entrambi. Il livello superiore ha sempre questi campi:

```json
{
  "format": "acepdfmd-document",
  "version": 1,
  "source": {"type": "pdf", "filename": "report.pdf", "title": "Q3 Report", "pages": 12},
  "pages": [{"number": 1, "width": 612, "height": 792, "words": 380, "text": "..."}],
  "blocks": [
    {"type": "heading", "level": 1, "text": "Q3 Report"},
    {"type": "paragraph", "text": "Revenue grew..."},
    {"type": "list", "ordered": false, "items": [{"level": 0, "text": "Europe"}]},
    {"type": "table", "header": ["Region", "Q3"], "rows": [["Europe", 1200.5]]}
  ],
  "tables": [{"index": 1, "page": 3, "rows": [["Region", "Q3"], ["Europe", 1200.5]]}],
  "form_fields": [{"name": "email", "type": "text", "value": "a@b.com"}],
  "extraction": {"engine": "pdf_to_markdown/layout", "mode": "structure", "ocr": false, "warnings": []}
}
```

I campi hanno il seguente significato:

- source: cos'era il file, con i metadati che portava (titolo, autore, oggetto, parole chiave, date di creazione e modifica, numero di pagine). I file Word aggiungono il numero di parole, tabelle e immagini.
- pages: una voce per ogni pagina del PDF con le sue dimensioni in punti, la rotazione, un conteggio delle parole e il suo testo. I file Word non hanno pagine, perché Word impagina solo quando stampa.
- blocks: il documento nell'ordine di lettura. I tipi sono heading (con livello da 1 a 6), paragraph (con un nome di stile opzionale da Word), list (ordinato o non, con elementi che hanno un livello di nidificazione), table (intestazione più righe tipizzate), code, blockquote, rule e image.
- tables: per i PDF, ogni tabella rilevata con la pagina in cui è stata trovata e, per una tabella che continua, la pagina in cui termina. Le celle che sembrano numeri sono numeri.
- form_fields: presente solo quando il PDF ha un modulo. Ogni campo ha il suo nome, il tipo (text, choice, button o signature) e il valore attuale.
- extraction: quale convertitore è stato eseguito, la modalità scelta, se è stato necessario l'OCR e qualsiasi avviso, ad esempio una tabella che non è stato possibile rilevare.

La versione 1 di questo formato guadagna solo nuovi campi; i campi esistenti mantengono i loro nomi e il loro significato.

## Dati tabellari e nidificazione

CSV ed Excel sono piatti, JSON non lo è. Quando JSON passa a CSV o Excel, gli oggetti annidati vengono appiattiti in nomi di colonna con notazione a punti e gli array in nomi indicizzati, così un record d'ordine con un oggetto customer e un array items diventa colonne come customer.name, items[0].sku e items[1].sku. Quando CSV o Excel torna a JSON, le intestazioni scritte in questo modo vengono ricostruite in oggetti e array annidati. Un'intestazione con un punto ordinario, come un numero di versione o un'abbreviazione, viene lasciata così com'è.

I valori sono tipizzati in ingresso: i numeri diventano numeri, true e false diventano booleani, una cella vuota diventa null, e tutto il resto resta una stringa. Le date provenienti da Excel vengono scritte come stringhe ISO 8601, perché JSON non ha un tipo data. Imposta l'opzione dei tipi di valore su testo quando gli identificatori con zeri iniziali devono restare esattamente come scritti.

## Validazione e riparazione

Ogni strumento JSON valida il suo input nello stesso modo. Un file non valido viene rifiutato con la riga e la colonna del primo errore, e un breve estratto di quella riga. Il [Formattatore JSON](https://acepdfmd.com/it/tool/json-formatter/) può anche riparare gli errori che le persone incollano più spesso: commenti, virgole finali, stringhe tra apici singoli, chiavi senza virgolette, True, False e None con la maiuscola, NaN e Infinity, e blocchi di codice attorno al testo. Quando è stata applicata una riparazione, il risultato te lo indica, così nulla cambia silenziosamente senza che tu lo sappia.

## Privacy

I file caricati e il testo incollato vengono elaborati sui nostri server ed eliminati entro 60 minuti; consulta la [guida sulla privacy](https://acepdfmd.com/it/guides/privacy-guide/) per i dettagli. Nulla viene conservato oltre quel tempo e nulla viene usato per qualsiasi altro scopo.

## Strumenti citati in questa guida

- [PDF in JSON](https://acepdfmd.com/it/tool/pdf-to-json/): Estrai testo, titoli, elenchi, tabelle, campi modulo e metadati di un PDF come JSON strutturato.
- [Word in JSON](https://acepdfmd.com/it/tool/word-to-json/): Trasforma un documento Word in JSON: titoli, paragrafi, elenchi e tabelle nell'ordine di lettura.
- [Excel in JSON](https://acepdfmd.com/it/tool/excel-to-json/): Convertire i fogli di lavoro Excel in record, righe o colonne JSON, con numeri e date reali.
- [CSV in JSON](https://acepdfmd.com/it/tool/csv-to-json/): Convertire CSV o TSV in un array JSON di oggetti, con numeri tipizzati e chiavi annidate.
- [YAML in JSON](https://acepdfmd.com/it/tool/yaml-to-json/): Convertire YAML in JSON pulito, inclusi i file multi-documento.
- [XML in JSON](https://acepdfmd.com/it/tool/xml-to-json/): Convertire XML in JSON con attributi, elementi ripetuti come array e valori tipizzati.
- [JSON in PDF](https://acepdfmd.com/it/tool/json-to-pdf/): Trasforma JSON in un PDF leggibile: i record diventano tabelle, i dati annidati una struttura a indice.
- [JSON in Excel](https://acepdfmd.com/it/tool/json-to-excel/): Convertire JSON in una cartella di lavoro Excel, un foglio per ogni elenco di record, con le chiavi annidate come colonne.
- [JSON in CSV](https://acepdfmd.com/it/tool/json-to-csv/): Appiattisci i record JSON in un file CSV che si apre in qualsiasi foglio di calcolo.
- [JSON in Word](https://acepdfmd.com/it/tool/json-to-word/): Convertire JSON in un documento Word modificabile con titoli, elenchi e tabelle.
- [JSON in HTML](https://acepdfmd.com/it/tool/json-to-html/): Rendi JSON come una pagina HTML autonoma con tabelle e una struttura a indice stampabile.
- [JSON in YAML](https://acepdfmd.com/it/tool/json-to-yaml/): Convertire JSON in YAML leggibile con le chiavi nel loro ordine originale.
- [JSON in XML](https://acepdfmd.com/it/tool/json-to-xml/): Convertire JSON in XML ben formato e indentato, con un elemento radice a tua scelta.
- [Formattatore JSON](https://acepdfmd.com/it/tool/json-formatter/): Valida, formatta, minifica, ordina o ripara JSON, con la riga e la colonna esatte di ogni errore.
- [Confronta JSON](https://acepdfmd.com/it/tool/json-compare/): Confronta due file JSON a livello strutturale ed elenca ogni valore aggiunto, rimosso e modificato per percorso.
- [Markdown in JSON](https://acepdfmd.com/it/tool/markdown-to-json/): Esporta la struttura del documento come albero sintattico JSON (AST pandoc).
- [JSON in Markdown](https://acepdfmd.com/it/tool/json-to-markdown/): Trasforma dati JSON o un AST pandoc in Markdown leggibile con tabelle.

## Altre guide

- [Guida rapida a Markdown: sintassi ed esempi](https://acepdfmd.com/it/guides/markdown-cheat-sheet/)
- [Formati e dimensioni delle pagine PDF: A4, Letter, Legal e altri](https://acepdfmd.com/it/guides/pdf-page-sizes/)
- [Compressione PDF: come funziona e perché alcuni file si riducono poco](https://acepdfmd.com/it/guides/pdf-compression-guide/)
- [Da PDF a Markdown: come funziona e come usarlo per l'IA](https://acepdfmd.com/it/guides/pdf-to-markdown-guide/)
- [OCR per PDF e immagini: come ottenere testo accurato](https://acepdfmd.com/it/guides/ocr-guide/)
- [È sicuro caricare un PDF online? Una guida alla privacy](https://acepdfmd.com/it/guides/privacy-guide/)
- [Aprire e convertire file iWork (Pages, Numbers, Keynote) senza Mac](https://acepdfmd.com/it/guides/iwork-guide/)