Come creare una tabella Markdown
Questo editor serve per piccole tabelle di documentazione, confronti nei README e note di rilascio che devono restare leggibili come testo semplice.
- Copia un intervallo rettangolare da un foglio di calcolo e incollalo nella casella «Dati del foglio di calcolo», poi scegli «Sostituisci la griglia con le celle incollate». Le tabulazioni separano le colonne e le interruzioni di riga separano le righe. La prima riga incollata viene considerata l'intestazione.
- Controlla ogni cella della griglia. Puoi anche incollare un blocco di più celle direttamente in una cella della griglia: l'editor si espande da quel punto, entro i limiti di 100 righe e 20 colonne.
- Aggiungi o rimuovi righe e colonne secondo necessità. Scegli l'allineamento a sinistra, al centro o a destra per ciascuna colonna. L'ordinamento modifica soltanto le righe di dati, quindi l'intestazione resta in cima.
- Confronta il sorgente generato con l'anteprima sicura. Quando numero di righe, intestazioni, allineamento e valori sono corretti, copia il Markdown e incollalo nel tuo README, issue, wiki o editor Markdown.
Come funziona la sintassi generata
Una tabella Markdown comune usa barre verticali per separare le celle. La prima riga è l'intestazione e la seconda è un delimitatore formato da trattini. I due punti nel delimitatore indicano l'allineamento: :--- a sinistra, :---: al centro e ---: a destra. Le righe restanti contengono i dati.
Il generatore aggiunge spazi alle celle per rendere più leggibile il sorgente grezzo. Nei comuni sistemi di visualizzazione delle tabelle, questi spazi non modificano il valore della cella. Le celle vuote restano presenti, mantenendo lo stesso numero di colonne in ogni riga.
Una barra verticale letterale in una cella viene scritta come \| per non confonderla con il confine di una colonna. Un'interruzione di riga reale in una cella incollata diventa <br>, perché le normali tabelle in stile GFM non hanno una sintassi portabile per celle su più righe. I backslash vengono neutralizzati prima delle barre verticali.
L'anteprima crea volutamente una normale tabella HTML da nodi di testo invece di eseguire il Markdown generato. È utile per verificare struttura, valori e allineamento, ma l'aspetto finale può cambiare tra GitHub, un generatore di siti statici, un wiki o un'altra variante Markdown.
Esempi svolti
Tabella dello stato di un progetto
Incolla «Task», «Owner» e «Status» come intestazione, seguiti da due righe del foglio di calcolo. Centra la colonna Status e ordina per Owner.
| Task | Owner | Status |
| :--- | :--- | :---: |
| Docs | Ada | Ready |
L'intestazione resta per prima mentre vengono ordinate soltanto le righe di dati. Il delimitatore centrato resta associato alla colonna Status.
Caratteri speciali e interruzioni di riga
Inserisci Plan | Actual in una cella e incolla «First line», un'interruzione di riga e «Second line» in un'altra.
| Metric \| view | Note |
| :--- | :--- |
| Plan \| Actual | First line<br>Second line |
La barra verticale viene neutralizzata e la nuova riga diventa <br>. L'anteprima sicura mostra il testo senza eseguire eventuale markup incorporato.
Quando è utile questo strumento
Usalo per confronti tra funzioni, matrici di ambienti, riferimenti di scorciatoie, elenchi di rilascio o piccoli riepiloghi facili da rivedere nelle differenze del controllo versioni.
Incolla un intervallo esistente di un foglio di calcolo oppure modifica direttamente la griglia se servono solo poche intestazioni e valori.
L'ordinamento aiuta la presentazione, non esegue calcoli. Il confronto naturale mette Item 2 prima di Item 10 e i valori vuoti per ultimi.
Limiti e soluzioni comuni
- Sono supportate solo tabelle semplici. Markdown non offre una sintassi ampiamente portabile per celle unite o celle estese su più righe o colonne.
- La casella di importazione richiede tabulazioni. Per CSV con virgole tra virgolette o interruzioni incorporate, apri il file in un foglio di calcolo e copia le celle.
- I limiti sono 100 righe, 20 colonne e 2,000 caratteri per cella. Suddividi i dati più grandi in tabelle circoscritte.
- Il Markdown in linea viene conservato nell'output ma non interpretato da questa anteprima. Verificalo nel sistema di pubblicazione.
- Gli spazi iniziali e finali vengono rimossi: questo strumento non è adatto quando tali spazi sono dati significativi.
Copiare e controllare il risultato
Copia e incolla come testo semplice. Se l'accesso agli appunti è bloccato, seleziona manualmente il codice. Nulla viene caricato o salvato, quindi conserva il risultato prima di chiudere la scheda.
Verifica che la destinazione supporti tabelle GFM con barre verticali e <br>. L'anteprima controlla struttura e valori, non garantisce uno stile identico in ogni sistema.
Domande frequenti
La prima riga diventa sempre l'intestazione?
Sì. Una tabella con barre verticali richiede un'intestazione e una riga delimitatrice, quindi la prima riga della griglia viene sempre esportata come intestazione. Sposta o modifica i dati prima di copiare se l'intervallo incollato non conteneva titoli.
Posso unire le celle?
No. Le comuni tabelle Markdown in stile GFM non offrono una sintassi portabile per celle unite. Usa righe separate, ripeti un'etichetta oppure scegli HTML se le celle unite sono indispensabili.
Perché i dati incollati sono diventati una sola colonna?
La casella di importazione separa le colonne mediante tabulazioni, come quelle prodotte copiando celle da un foglio di calcolo. Non interpreta CSV grezzo separato da virgole: aprilo in un foglio di calcolo e copia le celle.
Markdown o HTML in una cella vengono eseguiti?
Non in questa anteprima: vengono mostrati come testo. Il Markdown copiato contiene comunque ciò che hai inserito, quindi è il sistema di destinazione a decidere come gestire il markup; incolla soltanto contenuti affidabili.
L'ordinamento cambia l'intestazione?
No. L'ordinamento riguarda soltanto le righe di dati e mantiene unite le righe complete. Non calcola formule né deduce tipi di dati oltre all'ordinamento naturale di testo e numeri.
La mia tabella viene caricata o salvata?
No. Modifica, ordinamento, anteprima e generazione avvengono in questa scheda del browser. Non ci sono account o cronologia e ricaricare la pagina cancella la tabella attuale.