Come convertire JSON o CSV in una tabella Markdown

Quando usare il convertitore

Questo strumento converte testo in formato JSON o CSV in una tabella Markdown, se l’elaborazione va a buon fine. È utile quando hai dati già disponibili come testo e vuoi ottenere una struttura tabellare da copiare in una documentazione o in un contenuto Markdown.

Puoi scegliere il formato dell’input, incollare i dati, indicare eventualmente le intestazioni e selezionare l’allineamento delle colonne. Per il JSON, la struttura deve essere compatibile con una riga o con più righe; per il CSV, il risultato dipende dalle righe e dai campi separati da ritorni a capo e virgole.

Procedura

1. Prepara i dati come testo JSON o CSV. Se usi JSON, controlla che sia valido e che abbia una struttura adatta a rappresentare una o più righe. Un oggetto JSON non vuoto viene trattato come una sola riga; un elenco vuoto, un oggetto vuoto o un altro valore JSON vuoto produce invece una tabella vuota.

2. Inserisci il testo nell’area dati e seleziona il formato corretto: json oppure csv. Non lasciare l’area vuota, perché l’invio senza dati non produce una tabella.

3. Se necessario, aggiungi le intestazioni personalizzate in un unico campo, separandole con virgole. Gli spazi attorno a ciascuna intestazione vengono rimossi. Se non specifichi intestazioni, per un JSON adatto vengono usate le chiavi della prima riga; per un CSV la prima riga diventa l’intestazione e le righe successive diventano i dati.

4. Scegli l’allineamento delle colonne: left, center o right. left è l’impostazione predefinita. Un valore diverso da queste tre opzioni viene ricondotto all’allineamento a sinistra.

5. Avvia l’elaborazione e copia il testo Markdown della tabella se il risultato viene generato. Se il contenuto non è valido o non presenta una struttura compatibile, correggi i dati e riprova.

Come leggere il risultato

Un risultato riuscito contiene testo Markdown organizzato come tabella, con una riga di intestazione, una riga di separazione e le righe dei dati. Nel caso di un JSON non vuoto, le intestazioni predefinite derivano dalle chiavi della prima riga quando la struttura è adatta. Nel caso di un CSV senza intestazioni personalizzate, la prima riga del testo definisce le intestazioni.

Il trattamento del CSV è basato sulla separazione diretta per caratteri di nuova riga e virgola. Gli spazi iniziali e finali dei campi vengono rimossi. I campi oltre il numero di intestazioni vengono scartati, mentre quelli mancanti generano celle vuote: verifica quindi che la disposizione delle colonne sia coerente prima di copiare il risultato.

Un JSON malformato restituisce un esito non riuscito. Anche un JSON formalmente valido può non produrre una tabella se la sua forma non offre la struttura di riga attesa. Un valore JSON vuoto, come null, false, 0, una stringa vuota, un elenco vuoto o un oggetto vuoto, viene trattato come tabella vuota, non come riga compilata.

Esempio pratico

Hai un oggetto JSON che contiene il nome e il ruolo di una persona e vuoi trasformarlo in una tabella Markdown a due colonne.

Inserisci il JSON non vuoto con le chiavi nome e ruolo, seleziona json, lascia vuote le intestazioni personalizzate e avvia l’elaborazione.

Il risultato ha una riga di intestazione con nome e ruolo, una riga separatrice Markdown e una riga dati con i due valori forniti.

Limiti

• Il CSV viene diviso direttamente per ritorni a capo e virgole; i campi oltre il numero di intestazioni vengono scartati e quelli mancanti diventano vuoti.

Errori comuni

• Se l’elaborazione fallisce, una causa può essere la selezione di un formato diverso da JSON o CSV oppure l’assenza di dati. Seleziona il formato supportato corrispondente al testo e inserisci un contenuto non vuoto prima di inviare.

Domande frequenti

Posso convertire qualsiasi JSON in una tabella Markdown?

Sì, se il testo JSON è valido e presenta una struttura di riga compatibile. Un JSON formalmente valido ma non adatto alla struttura attesa può comunque causare un’elaborazione non riuscita.

Come vengono interpretate le intestazioni in un CSV?

Sì. Senza intestazioni personalizzate, la prima riga del CSV viene usata come intestazione e le righe successive come dati. La separazione avviene per ritorni a capo e virgole, quindi le convenzioni CSV avanzate non sono gestite.

Posso sostituire le intestazioni generate automaticamente?

Puoi fornire intestazioni personalizzate come testo separato da virgole. Gli spazi attorno a ciascun nome vengono rimossi prima dell’uso.