Conversione da CSV a tabella Markdown
Converte un file CSV nella notazione tabellare di Markdown, cioè `| col1 | col2 |`. Potete indicare il carattere separatore, la presenza di una riga d'intestazione e l'allineamento delle colonne, a sinistra, al centro o a destra; il risultato si può copiare e scaricare. Il contenuto del file è elaborato nel navigatore e non viene trasmesso ad alcun servente.
| Carattere separatore |
|
|---|---|
| Considera la prima riga come intestazione | |
| Allineamento delle colonne |
|
Inserite un file CSV per vedere qui la tabella Markdown.
Corrispondenza fra le righe del CSV e la tabella Markdown
| Una riga del CSV | name,age,city |
|---|---|
| Notazione Markdown risultante | | name | age | city | |
Usando la prima riga come intestazione, essa diventa la riga dei titoli, la seconda è la riga separatrice che indica l'allineamento, con i trattini, e dalla terza in poi seguono le righe di dati.
Che cos'è un convertitore da CSV a tabella Markdown
Una tabella Markdown è disegnata soltanto con barre verticali e trattini: perfettamente leggibile come testo semplice, ma faticosa da scrivere a mano non appena le colonne superano un paio. Se i dati di partenza esistono già in formato CSV — esportati da un foglio di calcolo, ottenuti da una query su un database o estratti da un file di log — non ha senso ridigitarli cella per cella. Questo strumento legge il CSV e lo ricostruisce come una vera tabella Markdown: una riga di intestazione, una riga separatrice che indica l'allineamento delle colonne e una riga di dati per ogni riga in ingresso.
Poiché una riga di tabella Markdown deve stare fisicamente su un'unica riga, durante la conversione alcuni aggiustamenti avvengono in automatico. Le barre verticali presenti all'interno di una cella vengono protette per non essere scambiate per un confine di colonna, e i ritorni a capo dentro celle multiriga racchiuse fra virgolette vengono ridotti a un unico spazio. È inoltre possibile scegliere l'allineamento a sinistra, al centro o a destra per le colonne, il che inserisce nella riga separatrice la combinazione di due punti e trattini corrispondente. Tutto avviene localmente nel navigatore, quindi il CSV incollato non lascia mai il vostro computer.
Come generare una tabella Markdown da un CSV
- Incollate i dati CSV Incollate il testo CSV nel campo di inserimento. Se lo avete copiato direttamente da un foglio di calcolo, impostate il separatore su tabulazione anziché virgola.
- Decidete se la prima riga è un'intestazione Se la prima riga contiene i nomi delle colonne, attivate "Considera la prima riga come intestazione": la riga separatrice verrà inserita automaticamente subito sotto.
- Scegliete l'allineamento delle colonne Le colonne numeriche si leggono meglio allineate a destra. Lasciando l'allineamento non specificato, il visualizzatore Markdown applica il proprio comportamento predefinito.
- Copiate il risultato nel documento Copiate il Markdown generato e incollatelo in un README, una segnalazione, la descrizione di una pull request o un articolo tecnico.
Consigli per sfruttarlo al meglio
- Le barre verticali contenute nelle celle vengono protette automaticamente con una barra rovesciata, così da non essere scambiate per separatori di colonna.
- I ritorni a capo contenuti nelle celle racchiuse fra virgolette sono sostituiti da uno spazio, perché una riga di una tabella Markdown deve stare fisicamente su una sola riga.
- Scegliendo l'allineamento a sinistra, al centro o a destra, nella riga separatrice compaiono rispettivamente `:---`, `:---:` e `---:`, e la tabella appare come voluto nei visualizzatori come quello di GitHub.
- Insieme agli strumenti affini di conversione da CSV a JSON e da CSV a SQL potete trasformare uno stesso file in tre formati diversi secondo l'uso.
Quando torna utile un convertitore da CSV a Markdown
Tabelle in un README
Organizzate prima in un foglio di calcolo una matrice di compatibilità o un elenco di opzioni di configurazione, poi convertitela: otterrete una tabella Markdown pulita senza dover regolare a mano la larghezza delle colonne.
Confronti in segnalazioni e pull request
Trasformate al volo i risultati di un test o un elenco di candidati in una tabella. Restando testo semplice, si legge bene anche all'interno di un diff.
Preparare dati per un articolo tecnico
I dati di una misurazione possono diventare direttamente una tabella nell'articolo. Allineare a destra le colonne numeriche mantiene le cifre in colonna e facili da confrontare a colpo d'occhio.
Mettere ordine in verbali e documentazione
Utile quando un elenco finora gestito in un foglio di calcolo passa a una documentazione mantenuta in Markdown.
Termini delle tabelle Markdown
- Notazione tabellare
- La sintassi Markdown che dispone una tabella come celle separate da barre verticali. Non faceva parte della specifica originaria ed è stata aggiunta in seguito come estensione.
- Riga separatrice
- La riga di trattini posta subito sotto la riga dei titoli. Indica all'analizzatore dove finisce l'intestazione e iniziano i dati.
- Indicatore di allineamento
- I due punti aggiunti accanto ai trattini della riga separatrice per indicare l'allineamento a sinistra, al centro o a destra di quella colonna.
- GFM
- Sigla di GitHub Flavored Markdown, una specifica estesa definita da GitHub, diventata lo standard di fatto per la notazione tabellare.
- Protezione (escape)
- L'operazione che antepone una barra rovesciata a una barra verticale dentro una cella, così da evitare che venga scambiata per un separatore di colonna.
Domande frequenti
A proposito — perché una tabella Markdown si scrive con sole barre verticali e trattini
Markdown è un linguaggio di marcatura leggero ideato nel 2004 da John Gruber e Aaron Swartz, il cui principio ispiratore è che il testo resti comprensibile anche letto in chiaro. La notazione tabellare non fa eccezione: rappresentando i filetti con sole barre verticali e trattini, non occorre racchiudere nulla fra marcatori di apertura e chiusura come nel <table> dell'HTML, e già guardando il sorgente si intuisce la forma della tabella.
La notazione tabellare, per inciso, non figurava nella specifica originaria di John Gruber: è un'estensione aggiunta più tardi e in modo autonomo da PHP Markdown Extra e dal Markdown di GitHub. Per questo il comportamento nei dettagli, per esempio quando il numero di colonne non coincide, varia leggermente da un'implementazione all'altra; le piattaforme principali si conformano per lo più alla variante di GitHub.
Il desiderio di incollare in un documento il risultato di un foglio di calcolo o di una base di dati ricorre di frequente scrivendo file di presentazione, segnalazioni o articoli tecnici. Battere a mano barre verticali e righe separatrici è faticoso, e uno strumento che converte con un clic a partire da un file CSV è ormai una preparazione di rito per chi documenta in Markdown.