Generatore di Tabelle Markdown

Le tabelle Markdown sono esigenti: una pipe mancante o una riga di separazione non uniforme e l’intera tabella viene visualizzata come testo normale. Questo generatore ti offre una griglia visiva in cui digitare, ti consente di incollare CSV o TSV da un foglio di calcolo e produce una tabella Markdown con padding in cui le colonne si allineano nel sorgente, molto più facile da leggere in un diff e correggere al primo tentativo.

Come costruire una tabella Markdown

  1. 1

    Scegli righe e colonne

    Oppure incolla CSV/TSV e lo strumento inferisce automaticamente le dimensioni.

  2. 2

    Digita i contenuti delle celle

    Clicca in ogni cella. I tasti Tab e freccia navigano come in un foglio di calcolo.

  3. 3

    Imposta l'allineamento delle colonne

    Sinistra (predefinito), centro o destra per colonna tramite la riga di intestazione.

  4. 4

    Copia l'output Markdown

    Lo strumento aggiunge padding alle pipe per la larghezza delle colonne in modo che il sorgente appaia pulito.

Sintassi della tabella Markdown

Tabella di base:

| Colonna A | Colonna B | Colonna C |
|----------|----------|----------|
| cella 1   | cella 2   | cella 3   |
| cella 4   | cella 5   | cella 6   |

L’allineamento utilizza i due punti nella riga di separazione:

| Sinistra | Centro | Destra |
|:-----|:------:|------:|
| a    | b      | c     |
  • :--- allineamento a sinistra
  • :---: centro
  • ---: allineamento a destra

Cosa fa il generatore per te

  • Aggiunge padding a ogni cella per la larghezza della voce più lunga nella sua colonna, in modo che le pipe si allineino nel sorgente. Non influisce sull’output renderizzato, Markdown ignora gli spazi extra, ma gli esseri umani che leggono il diff ti ringrazieranno.
  • Escape delle pipe all’interno delle celle come \| in modo che una cella contenente a|b non si divida in due colonne.
  • Preserva l’allineamento quando cambi le larghezze delle colonne.
  • Accetta incolla CSV e TSV; rileva campi tra virgolette e virgole all’interno delle virgolette.

Errori comuni

  • La riga di separazione è obbligatoria. Le tabelle Markdown senza la riga |---|---| vengono visualizzate come testo normale.
  • Nessuna cella multi-linea. Ogni riga è una linea; inserisci <br> se hai bisogno di una rottura interna, poiché i ritorni a capo di Markdown all’interno delle celle della tabella non sono supportati.
  • Nessuna tabella nidificata. Se ne hai bisogno, torna all’HTML.
  • Celle vuote necessitano di uno spazio (o almeno di una coppia di pipe vuote). Evita || direttamente.

Quando usare HTML invece

Se hai bisogno di colspan, rowspan, celle multi-linea o classi CSS personalizzate, le tabelle HTML sono lo strumento giusto. La maggior parte dei parser Markdown accetta il markup delle tabelle HTML raw inline.

Dove funzionano bene le tabelle Markdown

  • README di GitHub, GitLab, Gitea.
  • Descrizioni di issue e PR.
  • Obsidian, Bear e la maggior parte delle app per prendere appunti.
  • Docusaurus, MkDocs, Hugo, tutti supportano le tabelle GFM.

Domande frequenti

Non nativamente. Usa <br> per i ritorni a capo inline. Per contenuti realmente multi-linea (blocchi di codice, elenchi all’interno di una cella), torna all’HTML <table>.

GFM non supporta celle unite. Se hai bisogno di colspan o rowspan, usa HTML all’interno del tuo documento Markdown, la maggior parte dei renderer passa <table> senza modificarlo.

No. L’HTML renderizzato è identico che tu aggiunga padding o meno, il padding è puramente una scelta di leggibilità del sorgente.

Sì. Copiare da un foglio di calcolo mette TSV (valori separati da tabulazioni) negli appunti. Il generatore rileva TSV e costruisce una tabella Markdown con le stesse righe e colonne.

Scrivi \|. La maggior parte dei parser quindi renderizza una pipe letterale senza rompere il confine della colonna.

Strumenti correlati

Strumento disponibile in altre lingue