Apri o incolla un file CSV: accanto alle opzioni compare una tabella con le pipe, pronta per un README, una issue o una pagina wiki. Un | dentro un valore viene scritto come \|, così non può mai spezzare una cella; gli a capo dentro una cella diventano <br> e le colonne numeriche vengono allineate a destra. Il file viene convertito nel browser e non viene mai caricato.
Come convertire un CSV in Markdown
- Scegli Apri file, trascina sullo strumento un file
.csv,.tsvo.txtoppure usa Incolla. Il delimitatore viene rilevato; se il risultato non torna, imposta delimitatore, codifica o La prima riga contiene le intestazioni in Impostazioni di importazione. - Scegli l’Allineamento delle colonne e come scrivere gli A capo nelle celle. La scheda Markdown mostra esattamente il testo che conterrà il file scaricato.
- Con Copia incolli la tabella direttamente in GitHub, GitLab o nel tuo editor; con «Scarica Markdown» salvi un file
.md.
Se il file non ha una riga di intestazione, disattiva La prima riga contiene le intestazioni: una tabella Markdown richiede sempre un’intestazione, quindi le colonne prendono i nomi Column 1, Column 2 e così via. Se invece ti serve una tabella per il web con gli stessi dati, usa Da CSV a HTML.
A cosa serve ogni opzione
| Numeri a destra, testo predefinito | È l’impostazione predefinita. Una colonna viene allineata a destra (---:) solo se tutti i valori non vuoti sono numeri semplici; con 00731 o 12 kg la colonna mantiene l’allineamento predefinito del renderer. |
|---|---|
| Predefinito (nessuno), Sinistra, Centro, Destra | Applicano lo stesso allineamento a tutte le colonne: --- semplice, :---, :---: o ---: nella riga di separazione. |
| Mantieni come <br> | Un a capo dentro una cella diventa <br>, che GitHub e la maggior parte dei renderer mostrano come nuova riga all’interno della cella. È l’impostazione predefinita. |
| Sostituisci con uno spazio | Ogni a capo diventa uno spazio: utile con i renderer che eliminano l’HTML. |
| Proteggi i caratteri Markdown | Attiva per impostazione predefinita. *, _, [, ], <, >, #, ~ e l’accento grave ricevono una barra rovesciata, così un valore come *fast* o <b> appare come l’hai scritto invece di diventare formattazione o HTML. Disattivala solo se le celle contengono Markdown che vuoi far interpretare. |
| Allinea le colonne nel testo sorgente | Attiva per impostazione predefinita. Riempie le celle di spazi in modo che il file .md grezzo si legga come una griglia. I caratteri larghi, come quelli cinesi, giapponesi o coreani, contano come due colonne. Disattivala per avere il risultato più compatto: la tabella visualizzata non cambia. |
Dati particolari: come vengono gestiti
- Pipe e barre rovesciate vengono sempre protette (
\|,\\), anche con Proteggi i caratteri Markdown disattivata, perché un|non protetto aprirebbe una nuova cella. - Virgole e a capo tra virgolette vengono letti secondo la RFC 4180, quindi
"Cable tidy, 3-pack"resta in una sola cella. Un avviso sopra l’anteprima indica quanti valori contenevano un a capo. - I valori vengono scritti come testo:
00731conserva i suoi zeri e34.90lo zero finale. Niente viene arrotondato o riformattato. - Un’intestazione vuota diventa
Column 3e una ripetutaname (2), così ogni colonna ha un titolo distinto. - I renderer Markdown tolgono gli spazi all’inizio e alla fine di una cella, e una tabella non può contenere elenchi o paragrafi: tieni contenuti del genere in un documento a parte.
Risoluzione dei problemi
- Il testo dopo la tabella si unisce all’ultima riga. Una tabella finisce solo con una riga vuota o con l’inizio di un altro blocco: lascia una riga vuota dopo di essa.
- Tutti i valori sono in una sola colonna. Il delimitatore è stato riconosciuto male. In Impostazioni di importazione scegli Virgola, Punto e virgola, Tabulazione o Barra verticale e riapri il file. I CSV salvati da Excel in italiano usano spesso il punto e virgola.
- **Nel risultato compaiono barre rovesciate prima di * o _.** È la protezione dei caratteri, mostrata da un renderer che non la interpreta. Se i tuoi dati non hanno caratteri di formattazione da proteggere, disattiva Proteggi i caratteri Markdown.
- Gli a capo compaiono come un tag letterale. Il renderer non accetta l’HTML. In A capo nelle celle scegli Sostituisci con uno spazio.
Limiti e privacy
I file fino a 25 MB, 100.000 righe o 2 milioni di celle si aprono con un’anteprima dal vivo delle prime 200 righe. Quelli più grandi vengono convertiti in streaming: il file viene letto due volte a blocchi (una per misurare le colonne e la loro larghezza, una per scrivere), un avviso ricorda che il download comprende l’intero file e Copia non è disponibile. Un singolo file di output può arrivare al massimo a 4 GB.
La conversione gira in un worker in background in questa scheda del browser: la pagina resta reattiva e Annulla la interrompe. Il CSV non viene mai inviato a un server. Per controllare un file grande prima di convertirlo, aprilo nel Visualizzatore CSV.
Esempio
Un elenco prodotti con uno SKU con zeri iniziali, una pipe dentro un nome, una virgola tra virgolette e una nota su due righe, convertito con le impostazioni predefinite. price è allineata a destra perché tutti i valori sono numeri; sku no, perché 00731 viene mantenuto come testo.
sku,name,price,note 00731,"Desk lamp | brass",34.90,"Ships in 2 days from Leeds" 00732,"Cable tidy, 3-pack white",4.50,Back-ordered until 14 March 2025 00733,USB-C hub,129.00,
| sku | name | price | note | | ----- | ------------------------ | -----: | -------------------------------- | | 00731 | Desk lamp \| brass | 34.90 | Ships in 2 days<br>from Leeds | | 00732 | Cable tidy, 3-pack white | 4.50 | Back-ordered until 14 March 2025 | | 00733 | USB-C hub | 129.00 | |
Domande frequenti
Il risultato funziona su GitHub?
Sì. È una tabella con pipe in GitHub Flavored Markdown: una riga di intestazione, una riga di separazione con i due punti facoltativi per l’allineamento e una riga per ogni riga del CSV. GitLab, Obsidian e la maggior parte dei generatori di siti statici leggono la stessa sintassi.
Perché nel sorgente vedo `\|`?
In una tabella Markdown un | semplice chiude la cella. La barra rovesciata dice al renderer di mostrare la pipe come testo, così Desk lamp | brass resta in una sola cella.
Posso riconvertire una tabella Markdown in CSV?
Non da questa pagina, che converte solo CSV e TSV in Markdown.