Tabelle Markdown: come scriverle e leggerle

Una tabella Markdown è testo semplice che diventa una griglia. Scrivi parole, barre verticali | e trattini -. Un lettore Markdown mostra righe e colonne.

Le tabelle sono ovunque nei file Markdown: listini prezzi, piani, confronti, risultati di test. Le chat IA e gli agenti di programmazione le scrivono di continuo.

La tabella di base

| Fruit  | Colour | Price |
|--------|--------|-------|
| Apple  | Red    | 1.20  |
| Banana | Yellow | 0.50  |

Ecco cosa mostra:

FruitColourPrice
AppleRed1.20
BananaYellow0.50

Tre tipi di righe:

  1. Riga di intestazione: i nomi delle colonne.
  2. Riga di trattini: separa l'intestazione dal resto. È obbligatoria. Senza di essa non c'è nessuna tabella.
  3. Righe di dati: una riga per ogni riga della tabella.

Le barre verticali | separano le celle. Le barre all'inizio e alla fine di ogni riga sono facoltative, ma rendono la tabella più facile da leggere.

Le colonne non devono essere allineate nel testo. Funziona anche così:

| Fruit | Colour | Price |
|---|---|---|
| Apple | Red | 1.20 |

Lascia una riga vuota prima e dopo la tabella. La tabella finisce alla prima riga vuota.

Allineare le colonne

Aggiungi i due punti : alla riga di trattini:

| Left | Centre | Right |
|:-----|:------:|------:|
| a    | b      | 1.20  |
| aa   | bb     | 10.50 |
LeftCentreRight
ab1.20
aabb10.50

Formattare dentro una cella

Le celle possono contenere grassetto, corsivo, code e link:

| Task      | Status   | Link                         |
|-----------|----------|------------------------------|
| Write     | **Done** | [Notes](https://example.com) |
| `npm test`| *Running*|                              |

Per inserire una barra verticale dentro una cella, scrivila come \|. Altrimenti inizia una nuova cella. Questo vale anche dentro code.

Cosa non possono fare le tabelle

Tabelle larghe

Una tabella con molte colonne diventa larga, soprattutto su un telefono. Qualche consiglio:

Modi rapidi per creare una tabella

Leggere le tabelle Markdown

In un editor di testo semplice, una tabella resta fatta di barre verticali e trattini. È leggibile per le tabelle piccole, ma difficile per quelle grandi. Un lettore Markdown mostra la vera griglia.

PilcrowMD mostra le tabelle Markdown su Android e Mac. Le celle possono mostrare grassetto, corsivo, link e formule. Su Android, una tabella larga scorre di lato, così le colonne non vengono schiacciate.

Domande frequenti

Una tabella Markdown è uguale ovunque? Per lo più sì. Le tabelle fanno parte di GitHub Flavored Markdown, che la maggior parte delle app segue. Alcune app Markdown molto semplici non mostrano affatto le tabelle.

Posso inserire un'interruzione di riga dentro una cella? Non nel Markdown standard. Alcune app accettano il tag HTML <br>, ma non tutte.

Devo allineare le barre verticali? No. Serve solo a rendere il testo più facile da leggere.

Anche su Mac: PilcrowMD per Mac (beta)