Web et encodage · 5 minutes de lecture

Tableaux Markdown : générer les au lieu de compter les tuyaux

Un tableau de démarques est une grille de cellules écrites avec des barres verticales et des tirets, et c'est la seule partie de la démarque qui est vraiment désagréable à écrire à la main. Compter les tuyaux, garder la ligne de délimiteur de la même largeur que l'en-tête et échapper à un tuyau qui apparaît à l'intérieur d'une cellule rivalisent pour attirer l'attention. La génération du tableau supprime les trois problèmes à la fois.

Mis à jour 12 octobre 2026

La syntaxe, dans un exemple

                | Tool          | Input       | Offline |
| :------------ | :---------: | ------: |
| YAML to JSON  | YAML        | yes     |
| JWT decoder   | JWT         | yes     |

La première ligne est l'en-tête, la seconde est la ligne de délimiteur et tout ce qui suit est constitué de données. Les deux points dans la ligne de délimiteur définissent l'alignement : `:---` à gauche, `:---:` au centre, `---:` à droite. GitHub et la plupart des moteurs de rendu acceptent les barres de début et de fin en option, mais leur inclusion permet de conserver le texte brut lisible dans un éditeur.

Les trois choses qui brisent les tables

Un tube à l'intérieur d'une cellule — échappez-le sous la forme `\|`, ou la ligne est divisée en une colonne de trop.
Une ligne de délimiteur avec un nombre incorrect de colonnes : l'en-tête est décalé et le tableau est mal aligné.
Une ligne vide à l'intérieur du tableau — le moteur de rendu la traite comme la fin du tableau et imprime le reste sous forme de texte.

L'évasion est la plus importante pour le code et les expressions régulières dans les cellules : `a|b` et `\bfoo\b` ont tous deux besoin d'attention avant de pouvoir vivre heureux dans une table.

Récupérer des données à partir d'une feuille de calcul

Le flux de travail naturel consiste à coller une sélection à partir d'une feuille de calcul ou d'une exportation CSV et à laisser le générateur effectuer le devis et l'alignement. C'est plus rapide et moins sujet aux erreurs que la saisie de lignes, et cela gère également les cas ennuyeux : largeurs de colonnes variables, nombres qui doivent être alignés à droite, cellules contenant des virgules. Coupez les colonnes vides de fin avant de coller pour éviter un tableau avec des colonnes fantômes qui s'affichent sous forme d'espaces.

Quand ne pas utiliser une table

Les tableaux sont destinés aux comparaisons : matrices de fonctionnalités, références d'indicateurs, listes de compatibilité, variables d'environnement. Ils sont médiocres pour la prose, mauvais pour les longues descriptions et pénibles sur les écrans étroits car le markdown n'a pas de comportement réactif - le moteur de rendu défile horizontalement ou réduit les colonnes en éclats illisibles. Si une cellule nécessite un paragraphe, utilisez plutôt une liste de définitions, un en-tête par entrée ou une liste à puces. Un tableau que personne ne peut lire sur un téléphone est pire que la liste qu’il a remplacée.

Générez, puis collez n'importe où

Le résultat est une simple démarque, il tombe donc directement dans un README, une description de demande d'extraction, une page wiki, un ticket Jira ou un commentaire. Le générateur de tableaux de démarques YamlBox s'exécute dans le navigateur, aligne les colonnes pour vous, évite les tuyaux et continue de fonctionner hors ligne — afin que vous puissiez coller des données internes sans les publier nulle part.

Markdown Générateur de tableaux — questions fréquemment posées

Comment insérer un caractère barre verticale dans une cellule de tableau de démarque ?

Échappez-le avec une barre oblique inverse — `\|` — sinon le moteur de rendu le traite comme la fin de la cellule. Les générateurs gèrent cela automatiquement, ce qui est la principale raison pour laquelle il est préférable de créer des tableaux avec un outil plutôt qu'à la main.

Comment aligner une colonne en démarque ?

Utilisez des deux-points dans la ligne de délimitation : `:---` pour la gauche, `:---:` pour le centre et `---:` pour la droite. L'alignement s'applique à toute la colonne, donc alignez à droite les colonnes numériques et alignez le texte à gauche pour un résultat le plus lisible.

Pourquoi mon tableau de démarques ne s'affiche-t-il pas ?

Vérifiez trois choses : la ligne de délimiteur a exactement autant de colonnes que l'en-tête, il n'y a pas de ligne vide à l'intérieur du tableau et la ligne d'en-tête précède directement la ligne de délimiteur. N'importe lequel de ces trois éléments interrompra le rendu dans une démarque à saveur GitHub.

Outils mentionnés dans cet article

CSV à JSON Convertissez les exportations CSV/TSV en tableaux JSON ou en lignes JSON. JSON à CSV Convertissez des tableaux JSON en fichiers CSV ou TSV prêts pour Excel. JSON Formateur Imprimez joliment, réduisez et validez JSON avec les emplacements exacts des erreurs. XML à JSON Convertissez RSS, SOAP, plans de site et configuration XML en JSON prévisible.

Parcourez la liste complète des 19 outils

Plus d'articles à lire

5 minutes de lecture