DevToolPal
IT

Convertitore da CSV a tabella Markdown

Trasforma CSV o TSV in una tabella Markdown ben allineata per README, documentazione e issue di GitHub.

Eseguito in locale, mai caricato

Opzioni

Input

0 caratteri · 0 B

Output

0 caratteri · 0 B

Cosa fa

Scrivere tabelle Markdown a mano è noioso: ogni riga richiede barre verticali, la seconda riga i trattini e allineare le colonne a mano richiede un’eternità. Questo strumento converte dati CSV o TSV in una tabella GitHub Flavored Markdown da incollare in un README, una pull request, una issue, una wiki o qualsiasi documentazione in Markdown.

Il CSV viene analizzato correttamente, quindi campi tra virgolette con virgole, virgolette raddoppiate e celle su più righe sono gestiti. L’output viene riempito di spazi perché le colonne risultino allineate anche in testo semplice, così la tabella è facile da leggere e modificare in seguito.

Come si usa

  1. Incolla CSV o TSV, carica un file .csv o .tsv, oppure fai clic su Esempio.
  2. Scegli l’Allineamento: predefinito, sinistra, centro, destra o Numeri a destra per allineare a destra le colonne che contengono solo numeri.
  3. Lascia attivo La prima riga è l’intestazione se la prima riga contiene i nomi delle colonne; altrimenti l’intestazione sarà Column 1, Column 2 e così via.
  4. Disattiva Allinea colonne se preferisci righe compatte senza riempimento.
  5. Copia la tabella o scaricala come file .md.

Le righe con meno celle dell’intestazione vengono completate con celle vuote, quindi la tabella è sempre valida.

Esempio

Questo CSV:

Tool,Stars,Notes
ripgrep,48000,"Fast, recursive search"
fd,34000,find | but friendlier

diventa questa tabella Markdown con l’allineamento Numeri a destra:

| Tool    | Stars | Notes                  |
| ------- | ----: | ---------------------- |
| ripgrep | 48000 | Fast, recursive search |
| fd      | 34000 | find \| but friendlier |

La virgola nel campo tra virgolette resta nella cella, la barra verticale viene sottoposta a escape e la colonna numerica riceve il marcatore --: per essere allineata a destra nel rendering.

Suggerimenti

  • I marcatori di allineamento nella seconda riga (:--, :-:, --:) stabiliscono come viene allineata ogni colonna nella tabella renderizzata.
  • Il Markdown in linea nelle celle, come **grassetto**, il codice in linea o i link, viene mantenuto e mostrato dalla maggior parte dei visualizzatori.
  • Le tabelle molto larghe sono difficili da leggere su schermi piccoli; valuta di dividere le colonne in più tabelle.
  • Per creare una tabella HTML, o trasformare un array JSON in una tabella Markdown, usa gli strumenti correlati qui sotto.

Domande frequenti

› Quale variante di Markdown usa la tabella?

Le tabelle con barre verticali di GitHub Flavored Markdown (GFM), supportate anche da GitLab, Bitbucket, Notion, Obsidian, Docusaurus, MkDocs e dalla maggior parte dei generatori di siti statici. Il CommonMark puro non ha una sintassi per le tabelle.

› Cosa succede a barre verticali e a capo dentro le celle?

Una barra verticale chiuderebbe la cella, quindi viene scritta come \|. Gli a capo non sono ammessi in una riga di tabella, quindi diventano tag <br>, che GitHub e la maggior parte dei renderer mostrano come a capo.

› Perché le colonne in cinese, giapponese o coreano risultano allineate?

Con Allinea colonne attivo, le celle vengono riempite in base alla larghezza di visualizzazione: i caratteri larghi dell’Asia orientale contano come due colonne, così il Markdown resta allineato in un editor con carattere monospaziato. La tabella renderizzata appare uguale in entrambi i casi.

› Posso convertire TSV copiato da Excel o Fogli Google?

Sì. Le celle copiate da un foglio di calcolo sono separate da tabulazioni e il delimitatore viene rilevato automaticamente. Puoi anche scegliere Tab esplicitamente.