Comment créer des tables dans Markdown

Les tableaux dans l’éditeur Markdown vous permettent d’organiser et de présenter les données dans un format structuré et lisible — utile pour comparer des fonctionnalités, des options de liste ou résumer des informations. Il existe deux façons de créer une table dans l’éditeur Markdown : utiliser l’icône de la barre d’outils Insérer table , ou taper manuellement la syntaxe de la table Markdown.

Quand utiliser les tables

• Comparaisons de caractéristiques — affichez les différences entre plans, options ou configurations côte à côte.
• Données de référence — listez les paramètres, les noms de champs ou les paramètres avec leurs descriptions dans un format structuré.
• Résumés structurés — présentent des ensembles de données où les lignes et colonnes rendent immédiatement claires les relations entre les valeurs.

Petite référence

Syntaxe des tables markdown

| Column 1 | Column 2 | Column 3 |
|:-------- |:--------:| --------:|
| Left     | Center   | Right    |

Alignement des colonnes

Limites

Comment créer une table dans Markdown

Utilisation de la barre d’outils

1. Ouvrez l’article souhaité dans l’éditeur Markdown du portail de la base de connaissances.

2. Cliquez sur l’icône Insérer table (⊞) dans la barre d’outils de l’éditeur.

   Une grille interactive apparaît.

3. Glissez pour sélectionner le nombre de lignes et de colonnes dont vous avez besoin. Vous pouvez sélectionner jusqu’à 10 colonnes × 15 lignes.

4. Pour ajouter plus de lignes au-delà de la sélection initiale, déplacez-vous vers une nouvelle ligne sous le tableau et entrez le contenu des cellules en utilisant des pipes verticaux (|) pour séparer chaque colonne. Chaque nouvelle ligne représente une ligne.

   Exemple :

   | Basic | Yes | Limited | Like    |
   | Pro   | Yes | Full    | Dislike |
   

Taper manuellement

1. Ouvrez l’article souhaité dans l’éditeur Markdown.

2. Typez pipes verticaux (|) et traits d’union (-) pour définir la structure de table. Utilisez les deux-points (:) dans la ligne séparatrice pour définir l’alignement des colonnes.

   Code exemple :

   | Column 1 | Column 2 | Column 3 |
   |:-------- |:--------:| --------:|
   | Left     | Center   | Right    |
   

3. La rangée séparatrice (deuxième ligne) est requise. Sans cela, le contenu ne sera pas affiché sous forme de tableau.

Résultat :

Comment créer un tableau sans ligne d’en-tête

Le Markdown standard nécessite toujours une ligne d’en-tête. Si vous avez besoin d’un tableau sans en-tête visible, utilisez plutôt la syntaxe HTML <table> :

<table>
  <tr>
    <td>Row 1</td>
    <td>Value 1</td>
  </tr>
  <tr>
    <td>Row 2</td>
    <td>Value 2</td>
  </tr>
</table>

Ajoutez plus <tr> de blocs pour des lignes supplémentaires et plus de <td> cellules dans chaque ligne pour des colonnes supplémentaires, en suivant la même structure.

Sortie :

Meilleures pratiques

• Incluez toujours une ligne d’en-tête — même si les noms de colonnes sont génériques (colonne 1, colonne 2), une ligne d’en-tête facilite l’analyse du tableau et est nécessaire pour la syntaxe standard de Markdown.
• Gardez le contenu des cellules concis — le long texte dans les cellules rend les tableaux difficiles à lire. Si une cellule nécessite plus qu’une phrase, envisagez d’utiliser une liste ou un paragraphe à la place.
• Utilisez l’alignement intentionnellement — alignez les colonnes de texte à gauche, alignez les colonnes numériques à droite, et utilisez l’alignement central avec parcimonie pour les labels ou les valeurs de statut.
• Utilisez la barre d’outils pour les tables rapides — l’icône Insérer une table est le moyen le plus rapide de créer une table standard. Passez à la syntaxe manuelle lorsque vous avez besoin d’un contrôle précis sur l’alignement ou lorsque vous ajoutez des lignes au-delà de la limite de 15 lignes de la barre d’outils.