Skip to main content

Organisation des informations avec des tables

Vous pouvez créer des tables pour organiser les informations dans les commentaires, les problèmes, les demandes de tirage et les wikis.

Qui peut utiliser cette fonctionnalité ?

Markdown peut être utilisé dans l’interface web GitHub.

Création d’une table

Vous pouvez créer des tables avec des barres verticales | et des traits d’union -. Les tirets servent à créer l'en-tête de chaque colonne, tandis que les barres verticales séparent chaque colonne. Vous devez ajouter une ligne vide avant votre table pour qu’elle s’affiche correctement.


| First Header  | Second Header |
| ------------- | ------------- |
| Content Cell  | Content Cell  |
| Content Cell  | Content Cell  |

Capture d'écran d'un GitHub tableau Markdown rendu en deux colonnes égales. Les en-têtes sont en caractères gras et les lignes de contenu alternatif sont grisées.

Les barres verticales situées à chaque extrémité de la table sont facultatives.

La largeur des cellules peut varier et ces dernières n’ont pas besoin d’être parfaitement alignées dans les colonnes. Il doit y avoir au moins trois traits d’union dans chaque colonne de la ligne d’en-tête.

| Command | Description |
| --- | --- |
| git status | List all new or modified files |
| git diff | Show file differences that haven't been staged |

Capture d'écran d'un GitHub tableau Markdown avec deux colonnes de largeur différente. Les lignes répertorient les commandes « git status » et « git diff » et leurs descriptions.

Si vous modifiez fréquemment des extraits de code et des tableaux, vous pouvez tirer parti de l’activation d’une police à largeur fixe dans tous les champs de commentaire de . Pour plus d’informations, consultez « À propos de l'écriture et de la mise en forme sur GitHub ».

Mise en forme du contenu dans votre table

Vous pouvez utiliser une mise en forme comme des liens, des blocs de code inclus et des styles de texte dans votre table :

| Command | Description |
| --- | --- |
| `git status` | List all *new or modified* files |
| `git diff` | Show file differences that **haven't been** staged |

Capture d'écran d'un GitHub tableau Markdown avec les commandes formatées comme des blocs de code. Les descriptions sont en gras et en italique.

Vous pouvez aligner le texte à gauche, à droite ou au centre d’une colonne en incluant des deux-points : à gauche, à droite ou des deux côtés des traits d’union dans la ligne d’en-tête.

| Left-aligned | Center-aligned | Right-aligned |
| :---         |     :---:      |          ---: |
| git status   | git status     | git status    |
| git diff     | git diff       | git diff      |

Capture d'écran d'un tableau Markdown à trois colonnes tel que rendu sur GitHub, montrant comment le texte à l'intérieur des cellules peut être aligné à gauche, au centre ou à droite.

Pour inclure une barre verticale | en tant que contenu dans votre cellule, utilisez un caractère \ avant la barre verticale :

| Name     | Character |
| ---      | ---       |
| Backtick | `         |
| Pipe     | \|        |

Capture d'écran d'un tableau Markdown tel que rendu sur GitHub montrant comment les tuyaux, qui ferment normalement les cellules, sont affichés lorsqu'ils sont précédés d'une barre oblique inverse.

Pour aller plus loin