Come fare una tabella in Markdown:sintassi, allineamento e celle su più righe.

La sintassi di base di una tabella Markdown

Le tabelle fanno parte di GitHub Flavored Markdown (GFM), il dialetto usato da GitHub, GitLab e dalla maggior parte delle app Markdown. Una tabella ha bisogno di tre cose:

1. Una riga di intestazione

   I nomi delle colonne, separati da barre verticali: | Nome | Ruolo |.

2. Una riga di delimitazione

   Una riga di trattini, un gruppo per colonna, subito sotto l'intestazione: | --- | --- |. Deve avere tante celle quanto l'intestazione, altrimenti il testo resta testo semplice e non compare nessuna tabella.

3. Le righe

   Una riga per ogni riga della tabella, con le celle separate da barre verticali. Una riga con troppe poche celle viene completata con celle vuote; le celle in più vengono scartate. La tabella termina alla prima riga vuota.

| Name  | Role     |
| ----- | -------- |
| Alice | Designer |
| Bob   | Engineer |

Ecco cosa vede chi legge:

Le barre verticali all'inizio e alla fine di ogni riga sono facoltative, ma rendono la tabella più leggibile. Nel testo le colonne non devono essere allineate; la spaziatura qui sopra serve solo alle persone. Le celle possono contenere grassetto, corsivo, codice, link e immagini.

Allineamento delle colonne in una tabella Markdown

Metti i due punti a sinistra, a destra o a entrambe le estremità dei trattini di una colonna:

| Item   | Qty | Price |
|:-------|:---:|------:|
| Pencil |  12 |  $1.50 |
| Ruler  |   3 |  $4.00 |

L'allineamento vale per l'intera colonna, intestazione compresa. Si imposta una sola volta nella riga di delimitazione, non cella per cella. Allinea i numeri a destra, così le cifre restano incolonnate.

Una barra verticale o una seconda riga in una cella

Una barra verticale chiude la cella, quindi una barra che fa parte del testo richiede una barra rovesciata. GFM lo applica anche dentro il codice in linea:

| Command            | Meaning          |
|--------------------|------------------|
| `a \| b`           | a pipe, in code  |
| Either \| or       | a pipe, in text  |

Una tabella a barre ha una riga di testo per ogni riga della tabella, quindi una cella non può contenere un vero a capo o un secondo paragrafo. Il modo consueto per aggirare il limite è il tag HTML <br>:

| Step  | What to do                          |
|-------|-------------------------------------|
| Build | Run the build.<br>Fix any errors.  |
| Ship  | Tag the release.<br>Push the tag.  |

Lo stesso trucco dà una cella su più righe su GitHub e nella maggior parte delle altre app che accettano HTML. Un elenco Markdown non funziona dentro una cella; se una cella ha bisogno di un elenco, scrivi <br> tra voci brevi oppure porta l'elenco fuori dalla tabella.

Tabelle larghe e testi lunghi

Markdown non ha un'impostazione per la larghezza delle colonne né un modo per unire le celle; è l'app che mostra la tabella a decidere come adattarla. Alcune abitudini la mantengono leggibile ovunque:

• Tieni le celle brevi, una parola o un numero. Metti la spiegazione lunga in una frase sotto la tabella.
• Usa meno colonne. Se una tabella ne ha otto, ruotala: le colonne diventano gli elementi e le righe le proprietà.
• Non riempire con spazi il testo per allineare le colonne di una tabella che modifichi spesso; una cella cambiata ti costringerebbe a rispaziare ogni riga.
• Per celle unite, righe estese o una didascalia, scrivi la tabella in HTML. La maggior parte delle app Markdown mostra un semplice <table>.

Perché una tabella Markdown non viene mostrata

• Manca la riga di delimitazione. È la riga di trattini che trasforma il testo in una tabella.
• Il numero di celle non coincide. Se l'intestazione ha tre celle e la riga di delimitazione due, non viene mostrato nulla.
• Una barra verticale senza escape in una cella la divide in due. Scrivi \|.
• Una riga vuota dentro la tabella. La tabella finisce lì; il resto è testo semplice.
• L'app non supporta le tabelle. Le tabelle non fanno parte del Markdown originale né del nucleo di CommonMark. Vengono da GFM, quindi un parser minimale mostra le barre come testo.

Per vedere il risultato prima del commit, apri il file in un lettore Markdown. DotMD mostra le tabelle renderizzate e si legge gratis. In DotMD Editor, Insert → Table inserisce nel file una tabella pronta a tre colonne, e l'anteprima live la ridisegna mentre scrivi.

Domande sulle tabelle Markdown

Altre domande