Markdown Tables: un guide complet de la syntaxe des tables GFM

Les tables Markdown vous permettent d'afficher des données structurées dans un format lisible qui rend comme une table HTML. Ce guide couvre l'ensemble des GFM (GitHub Aromatisé Markdown) syntaxe du tableau, options d'alignement, modèles avancés, et comment convertir les tables Word en Markdown.

Syntaxe de base des tableaux

Un tableau Markdown est constitué de trois parties:

1. Règle d'en-tête noms des colonnes
2. rangée de séparateur plateaux avec tuyaux, définit la table
3. Les lignes de données le contenu

| 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 |

Rendues comme suit:

Alignement des colonnes

Utilisez des colonnes dans la ligne de séparation pour contrôler l'alignement:

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

• :--- Aligner à gauche (par défaut)
• :---: Aligner le centre
• ---: Aligner à droite

Formatter à l'intérieur des cellules de la table

La plupart des formats Markdown en ligne fonctionnent à l'intérieur des cellules de table:

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

Ce qui ne fonctionne pas: contenu à plusieurs lignes, listes imbriquées, éléments au niveau des blocs.

Caractéristiques de tuyau dans les cellules

Si vous avez besoin d'une pipe littérale | à l'intérieur d'une cellule, s'échapper avec un backslash:

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

Tableaux sans espacement

L'espacement autour des tuyaux est facultatif. Ceci est valable:

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

Mais l'espacement cohérent rend les tableaux plus lisibles. La plupart des éditeurs et des linters préfèrent le format espacé.

Cellules vides

Laissez l'espace entre les tuyaux vide pour une cellule vide:

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

Conversion des tables Word en Markdown

Word les tables sont converties automatiquement lorsque vous utilisez WordToMD. The converter handles:

• Grilles standard → GFM tables de tuyauterie
• Largesse des colonnes → standardisé (Markdown ne contrôle pas la largeur des colonnes)
• Formatage du texte à l'intérieur des cellules → conservé (en gras, en italique, liens)

Ce qui ne convertit pas:

• Cellules fusionnées (intervalle/intervalle de lignes) effondrées dans la cellule la plus proche
• Contenu de cellule multilinéaire ruptures de ligne dépouillées
• Tables nichées Table intérieure aplatie

Tableaux de traitement complexe Word

Cellules fusionnées

Les cellules fusionnées de Word n'ont pas d'équivalent Markdown. Les options:

1. Régroupement Diviser les lignes fusionnées en tables séparées
2. Utilisez HTML La plupart des processeurs Markdown acceptent la syntaxe de table HTML:

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

Contenu de cellule à plusieurs lignes

Utilisation <br> pour les coupures de ligne à l'intérieur des cellules (travaille sur GitHub et la plupart des plates-formes):

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

Les grandes tables

Pour les tableaux avec de nombreuses colonnes, considérez si un tableau est le bon format. Des solutions de rechange:

• Une liste de définitions (terme + description)
• Tableaux multiples plus petits par catégorie
• Un bloc de code pour les données structurées (JSON, YAML)

Tableau rendu par plateforme

Accès

Pour une meilleure accessibilité, veillez à ce que les tableaux aient une ligne d'en-tête avec des noms de colonnes significatifs. Les lecteurs d'écran utilisent la ligne d'en-tête pour annoncer le contexte de la cellule.

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

Évitez d'utiliser des tableaux à des fins de mise en page utilisez-les uniquement pour les données de table réelles.

FAQ

Pourquoi mon tableau de rendu ne s'affiche pas comme texte ordinaire ? La ligne de séparation (la |---|---| L'établissement est obligatoire. Sans elle, l'analyseur ne reconnaîtra pas la structure de la table.

Je peux avoir une table sans en-tête ? Pas dans le GFM standard. La ligne d'en-tête et le séparateur sont requis. Si vous ne voulez pas d'en-tête visible, utilisez un en-tête vide: | | | avec une rangée séparatrice.

Pourquoi mes tables de Word sont-elles bien dans WordToMD mais mal après que je les ai collées ailleurs ? Le problème est généralement de laisser des espaces blancs dans les cellules ou des caractères de pipes incohérents. La plupart des rendus Markdown sont indulgents, mais le copier-coller peut introduire des caractères invisibles.

Comment créer une table à partir de données ? Des bibliothèques comme markdown-table (npm) ou Pythons tabulate peut générer des tables Markdown à partir de tableaux. Ceci est utile pour la conversion par lots de CSV ou de données de base de données.

Des guides connexes

• Qu'est-ce que le P_A? Markdown bases
• Markdown Syntaxe aide-mémoire Référence syntaxique complète
• Comment convertir Word en Markdown Guide complet de la conversion
• DOCX à Markdown avec des tableaux Concentré sur la conversion des tables

Conclusion de l'enquête

Les tables Markdown sont puissantes pour afficher des données structurées et sont largement prises en charge sur toutes les principales plateformes. Pour les tables qui commencent par Word, WordToMD les convertit automatiquement en syntaxe GFM. Pour les mises en page complexes, le repère HTML et les astuces ci-dessus vous donnent le contrôle dont vous avez besoin.