In questo articolo
Cosa sono le tabelle Markdown?
Le tabelle Markdown usano il carattere pipe (|) e i trattini (-) per creare dati tabulari strutturati all'interno di documenti di testo normale. Fanno parte di GitHub Flavored Markdown (GFM) e sono supportate dalla maggior parte dei renderer Markdown, inclusi GitHub, GitLab, VS Code e i generatori di siti statici.
Le tabelle in Markdown sono progettate per la presentazione semplice dei dati — intestazioni di colonna, riga separatore e righe di dati. Vengono rese come tabelle HTML appropriate nell'output, rendendole ideali per la documentazione, i file README e la scrittura tecnica senza alcuna conoscenza di HTML.
Sintassi delle tabelle Markdown
Una tabella Markdown è composta da tre parti: la riga di intestazione, la riga separatore e una o più righe di dati.
- Riga di intestazione — la prima riga definisce i nomi delle colonne, separati da caratteri pipe (|). I pipe iniziali e finali sono facoltativi ma consigliati per chiarezza.
- Riga separatore — la seconda riga usa trattini (---) tra i pipe per separare l'intestazione dai dati. Sono richiesti almeno tre trattini per colonna.
- Righe di dati — ogni riga successiva contiene valori di cella separati da pipe. Le celle non devono allinearsi visivamente, anche se le colonne allineate migliorano la leggibilità del sorgente.
- Escape dei pipe — se il contenuto di una cella contiene un carattere pipe letterale, eseguine l'escape con una barra rovesciata (\|) per evitare che venga interpretato come separatore di colonna.
Opzioni di allineamento delle colonne
L'allineamento delle colonne è controllato aggiungendo i due punti alla riga separatore. Questo determina come il testo è allineato all'interno di ogni colonna.
- Allineamento a sinistra (predefinito) — usa :--- o --- nel separatore. Il testo si allinea al bordo sinistro della colonna. È il valore predefinito quando non vengono specificati i due punti.
- Allineamento al centro — usa :---: nel separatore. Il testo è centrato all'interno della colonna. Utile per etichette di stato, categorie o valori brevi.
- Allineamento a destra — usa ---: nel separatore. Il testo si allinea al bordo destro. Ideale per valori numerici, prezzi, conteggi e misurazioni.
Prova gratuitamente — nessuna registrazione richiesta
Genera tabelle Markdown →Casi d'uso comuni
Le tabelle Markdown vengono utilizzate ovunque sia necessario presentare dati strutturati nella documentazione.
- Documentazione README — tabelle di confronto delle funzionalità del progetto, requisiti di installazione, piattaforme supportate e matrici di compatibilità delle versioni
- Documentazione API — riferimenti agli endpoint con metodo, percorso, descrizione e tabelle dei parametri per ogni route
- Tabelle di confronto — confronti affiancati delle funzionalità, livelli di prezzo e valutazioni degli strumenti in post di blog e recensioni tecniche
- Changelog — tabelle della cronologia delle versioni con data, numero di versione e descrizione delle modifiche per ogni rilascio
Consigli e migliori pratiche
Seguire queste linee guida aiuta a mantenere le tabelle Markdown leggibili sia in forma sorgente che renderizzata.
- Mantieni le colonne allineate nel sorgente — riempi le celle con spazi in modo che le colonne si allineino visivamente. La maggior parte degli editor e il nostro generatore lo gestiscono automaticamente. Il sorgente allineato è molto più facile da revisionare nelle pull request.
- Evita contenuti complessi nelle celle — le tabelle Markdown non supportano contenuto multi-riga, elementi blocco o tabelle annidate. Mantieni il contenuto delle celle breve e semplice. Per dati complessi, considera l'uso di tabelle HTML.
- Limita il numero di colonne — le tabelle con più di 5-6 colonne diventano difficili da leggere su schermi più piccoli. Considera di dividere le tabelle larghe in più tabelle mirate o di usare un formato diverso per dati molto larghi.
Domande frequenti
C'è un limite al contenuto delle celle nelle tabelle Markdown?
Non c'è un limite tecnico di caratteri per il contenuto delle celle, ma le celle delle tabelle Markdown sono solo a riga singola. Non puoi includere interruzioni di riga, paragrafi o elementi a livello di blocco come elenchi all'interno di una cella. Per contenuto di cella complesso, usa tabelle HTML con elementi <td> che supportano qualsiasi contenuto HTML.
Posso unire le celle nelle tabelle Markdown?
No. Le tabelle Markdown standard non supportano colspan o rowspan — ogni riga deve avere lo stesso numero di colonne. L'unione delle celle richiede tabelle HTML. Se hai bisogno di celle unite, scrivi la tabella in HTML e incorporala direttamente nel documento Markdown.
Posso annidare tabelle all'interno di tabelle Markdown?
No. Le tabelle Markdown non possono essere annidate. Ogni tabella è una griglia piatta di righe e colonne. Se hai bisogno di dati gerarchici, considera l'uso di elenchi annidati, tabelle separate con intestazioni o tabelle HTML con elementi <table> annidati.