La tabella di base
| Fruit | Colour | Price |
|--------|--------|-------|
| Apple | Red | 1.20 |
| Banana | Yellow | 0.50 |
Ecco cosa mostra:
| Fruit | Colour | Price |
|---|---|---|
| Apple | Red | 1.20 |
| Banana | Yellow | 0.50 |
Tre tipi di righe:
- Riga di intestazione: i nomi delle colonne.
- Riga di trattini: separa l'intestazione dal resto. È obbligatoria. Senza di essa non c'è nessuna tabella.
- 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 |
| Left | Centre | Right |
|---|---|---|
| a | b | 1.20 |
| aa | bb | 10.50 |
:---a sinistra:---:al centro---:a destra (adatto ai numeri)
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
- Niente celle unite. Ogni riga ha le stesse colonne.
- Niente elenchi o paragrafi in una cella. Una cella contiene una sola riga di testo.
- L'intestazione e la riga di trattini devono corrispondere. Se l'intestazione ha tre celle, anche la riga di trattini ne deve avere tre. Altrimenti ottieni testo semplice invece di una tabella.
- Le righe possono essere più corte o più lunghe. Una riga corta riceve celle vuote. Le celle in più alla fine di una riga lunga vengono scartate.
Tabelle larghe
Una tabella con molte colonne diventa larga, soprattutto su un telefono. Qualche consiglio:
- Tieni le celle brevi. Sposta il testo lungo sotto la tabella.
- Dividi una grande tabella in due più piccole.
- Metti per prima la colonna più importante.
Modi rapidi per creare una tabella
- Da un foglio di calcolo: molti convertitori online trasformano le celle copiate in una tabella Markdown.
- Da una chat IA: chiedi «una tabella Markdown» e indica quali colonne vuoi. Se la chat mostra una tabella formattata, chiedile di mettere il Markdown in un blocco di codice, così puoi copiare il testo.
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)