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.

Dans cet article

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’une table Markdown avec deux colonnes de largeur égale rendues sur GitHub. Les en-têtes s’affichent en gras, et les lignes de contenu alternatives ont une teinte grise.

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’une table Markdown avec deux colonnes de largeur différente affichées sur GitHub. 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 GitHub. 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’une table Markdown avec deux colonnes de largeur différente affichées sur GitHub. Les commandes « git status » et « git diff » sont mises en forme en tant que blocs de code.

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’une table Markdown avec trois colonnes affichées sur GitHub, montrant comment le texte dans les cellules peut être défini pour aligner à 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’une table Markdown telle qu’elle est affichée sur GitHub montrant comment les canaux, qui ferment normalement les cellules, peuvent s’afficher à l’intérieur des cellules lorsqu’ils sont précédés d’une barre oblique inverse.

Pour aller plus loin