Come convertire JSON in una tabella HTML o Markdown

Quando usare JSON to Table

JSON to Table serve a trasformare un array JSON di primo livello in una tabella leggibile, scegliendo tra HTML, Markdown oppure entrambe le rappresentazioni. È utile quando devi controllare rapidamente una serie di valori o confrontare oggetti JSON con campi non sempre presenti.

L’input deve essere un testo JSON valido il cui valore principale sia un array. Un singolo oggetto JSON, un valore semplice, un testo vuoto o un JSON non valido non producono una tabella. Per un array di valori semplici, il risultato viene organizzato in una tabella a una sola colonna. Per un array di oggetti, le colonne seguono l’ordine in cui le chiavi vengono incontrate.

Come convertire un array JSON in tabella

Prepara un array JSON di primo livello. Per esempio, puoi usare [{ "nome": "Anna", "eta": 30 }, { "nome": "Luca" }], mantenendo virgolette e parentesi nella sintassi JSON.
Incolla il contenuto nel campo di input. Controlla che non sia vuoto, che il testo sia JSON valido e che inizi con un array, quindi con [ e termini con ]. Non inserire un oggetto autonomo come valore principale.
Seleziona il formato desiderato. Se non ne indichi uno, l’output predefinito è HTML. Quando scegli Markdown, per un array non vuoto con almeno una colonna vengono create la riga d’intestazione e la riga separatrice. È disponibile anche una scelta combinata che genera entrambe le rappresentazioni.
Avvia la conversione e leggi la tabella restituita. Per gli array di oggetti, le colonne vengono raccolte nell’ordine della prima occorrenza delle chiavi. Se un oggetto successivo non contiene una chiave già raccolta, la cella corrispondente resta vuota. Nei valori HTML, i caratteri con significato speciale vengono convertiti in forma adatta al contenuto della tabella.
Verifica il risultato prima di copiarlo nel tuo documento. Se usi Markdown e una cella contiene il carattere |, quel carattere viene sottoposto a escape per non alterare la struttura della tabella.

Come leggere il risultato

Con un array di oggetti, il risultato è una tabella con una colonna per ciascuna chiave raccolta. Nell’esempio con nome ed eta, la forma attesa in Markdown comprende una riga d’intestazione con queste due colonne, una riga separatrice e poi due righe di dati; nella seconda riga, la cella relativa a eta è vuota perché quella chiave manca nel secondo oggetto.

Un array non vuoto composto soltanto da valori scalari viene invece rappresentato come tabella a colonna singola. Un array vuoto non produce una tabella. Fai attenzione anche agli array misti: i valori non oggetto finiscono solo nella prima colonna, mentre gli oggetti usano le colonne ricavate dalle loro chiavi; perciò la struttura può non essere rettangolare per ogni riga.

Esiste inoltre un caso limite in Markdown: se non viene raccolta alcuna chiave, come può accadere con [{}], possono comparire righe senza intestazione e senza riga separatrice. Un risultato senza tabella può quindi dipendere dall’input, non soltanto dal formato selezionato.

Esempio pratico

Devi confrontare due record, ma il secondo record non contiene il campo eta.

Incolla l’array JSON nel campo di input, seleziona Markdown e avvia la conversione. Controlla l’ordine delle colonne e la cella vuota nella seconda riga.

La rappresentazione Markdown contiene le colonne nome ed eta, una riga separatrice e due righe di dati; nella seconda riga, la cella eta è vuota.

Limiti

Gli array misti possono produrre righe non completamente rettangolari; inoltre, senza chiavi raccolte, il Markdown può non avere intestazione né riga separatrice.

Errori comuni

Errore: incollare un oggetto JSON autonomo oppure un testo non valido. Correzione: racchiudi gli elementi in un array di primo livello e verifica la sintassi prima di avviare la conversione.

Domande frequenti

Posso convertire direttamente un oggetto JSON?

Sì, ma solo se il valore JSON principale è un array. Un singolo oggetto non produce una tabella.

Il risultato Markdown include l’intestazione?

Sì. Per un array non vuoto con almeno una colonna, il formato Markdown include intestazione e riga separatrice; i caratteri | nelle celle vengono sottoposti a escape.

Che cosa succede con un array vuoto?

Non viene prodotta una tabella. Per ottenere un risultato, usa un array non vuoto con valori o oggetti JSON validi.