Markdown Tabelle: una guida completa alla sintassi delle tabelle GFM

Le tabelle Markdown consentono di visualizzare i dati strutturati in un formato leggibile che rende come una tabella HTML. Questa guida comprende l'intero GFM (GitHub Aromatizzato Markdown) sintassi della tabella, opzioni di allineamento, modelli avanzati e come convertire le tabelle Word in Markdown.

Sintassi di base della tabella

Una tabella Markdown ha tre parti:

1. riga di intestazione nomi delle colonne
2. riga del separatore cornici con tubi, definisce la tabella
3. Righe di dati il contenuto

| Column 1 | Column 2 | Column 3 |
|---|---|---|
| Row 1, Col 1 | Row 1, Col 2 | Row 1, Col 3 |
| Row 2, Col 1 | Row 2, Col 2 | Row 2, Col 3 |

Render come:

Allineamento delle colonne

Utilizzare le virgole nella riga separatore per controllare l'allineamento:

| Left aligned | Center aligned | Right aligned |
|:---|:---:|---:|
| text | text | text |
| longer text | longer text | longer text |

• :--- Allineamento a sinistra (di default)
• :---: Alineamento al centro
• ---: Allineamento a destra

Formattamento all'interno delle celle della tabella

La maggior parte delle impostazioni inline Markdown funziona all'interno delle celle della tabella:

| Element | Example |
|---|---|
| Bold | **bold text** |
| Italic | *italic text* |
| Code | `inline code` |
| Link | [click here](https://wordtomd.org) |
| Strikethrough | ~~deleted~~ |

Ciò che non funziona: contenuti a più righe, liste annidate, elementi a livello di blocco.

Caratteristiche del tubo nelle cellule

Se hai bisogno di una pipa letterale | all'interno di una cella, scappare con un backslash:

| Flag | Description |
|---|---|
| `x \| y` | Bitwise OR operator |

Tavole senza spazi

L'intervallo intorno ai tubi è facoltativo. Questo è valido:

|Column 1|Column 2|
|---|---|
|Cell|Cell|

Ma l'intervallo costante rende le tabelle più leggibili. La maggior parte degli editori e dei linter preferiscono il formato spaziato.

Cellule vuote

Lasciare lo spazio tra le tubazioni vuoto per una cella vuota:

| A | B | C |
|---|---|---|
| content | | content |
| | content | |

Convertire le tabelle Word in Markdown

Word le tabelle si convertono automaticamente quando si utilizza WordToMD. The converter handles:

• Griglie standard → GFM tavole di tubi
• Larghezza della colonna → standardizzata (Markdown non controlla la larghezza della colonna)
• Formattazione del testo all'interno delle celle → conservato (in grassetto, in corsivo, collegamenti)

Cosa non converte:

• Cellule fuse (spazio/spazio delle righe) collassate alla cellula più vicina
• Contenuto di celle multi-linee interruzioni di linea smantellate
• Tavoli annidati tavolo interno appiattito

Tavole di gestione complesse Word

Cellule fuse

Le cellule fusionate di Word non hanno equivalente Markdown. Opzioni:

1. Ristrutturazione Dividere le righe fuse in tabelle separate
2. Utilizzare HTML La maggior parte dei processori Markdown accetta la sintassi della tabella HTML:

<table>
  <tr>
    <th colspan="2">Merged Header</th>
  </tr>
  <tr>
    <td>Cell 1</td>
    <td>Cell 2</td>
  </tr>
</table>

Contenuto della cella multi-linea

Utilizzo <br> per interruzioni di linea all'interno delle celle (funzioni su GitHub e sulla maggior parte delle piattaforme):

| Step | Description |
|---|---|
| 1 | Open the file<br>Make sure it's .docx format |
| 2 | Drop it on [WordToMD](/#converter) |

Grandi tavoli

Per le tabelle con molte colonne, considerare se una tabella è il formato corretto. Altre alternative:

• Un elenco di definizioni (termine + descrizione)
• Tabelle più piccole per categoria
• Un blocco di codice per i dati strutturati (JSON, YAML)

Rendering delle tabelle per piattaforma

Accessibilità

Per una migliore accessibilità, assicurarsi che le tabelle abbiano una riga di intestazione con nomi di colonna significativi. I lettori di schermo usano la riga di intestazione per annunciare il contesto della cella.

| Product | Price | Availability |
|---|---|---|
| Widget A | $9.99 | In stock |
| Widget B | $14.99 | Out of stock |

Evitare l'uso di tabelle per la progettazione utilizzarle solo per i dati tabellari effettivi.

FAQ

Perché la mia tabella di rendering non viene visualizzata come testo semplice? La riga di separazione (la |---|---| Linea) è obbligatoria. Senza di essa, l'analisi non riconoscerà la struttura della tabella.

Posso avere un tavolo senza una riga di intestazione? Non nella norma GFM. Sono richiesti la riga di intestazione e il separatore. Se non si desidera un'intestazione visibile, utilizzare un'intestazione vuota: | | | con una riga separatrice.

Perché le tabelle di Word sembrano giuste in WordToMD ma sbagliate dopo averle incollate altrove? Il problema è di solito spazi bianchi traccianti nelle celle o caratteri di tubo incoerenti. La maggior parte dei renderer Markdown sono indulgenti, ma la copia-incolla può introdurre caratteri invisibili.

Come faccio a creare una tabella programmaticamente da dati? Librerie come markdown-table (npm) o Pythons tabulate può generare tabelle Markdown da array. Questo è utile per la conversione batch di CSV o dati di database.

Guida correlata

• Che cos'è il Markdown? Markdown basi
• Markdown Sintassi guida rapida Riferimento completo della sintassi
• Come convertire Word in Markdown Guida completa alla conversione
• DOCX a Markdown con tabelle Concentrati sulla conversione delle tabelle

Conclusioni

Le tabelle Markdown sono potenti per la visualizzazione di dati strutturati e sono ampiamente supportate su tutte le principali piattaforme. Per le tabelle che iniziano in Word, WordToMD li converte automaticamente in sintassi GFM. Per layout complessi, il backup HTML e i trucchi sopra ti danno il controllo di cui hai bisogno.