Générateur de Tableaux Markdown

Ce qu'est réellement un tableau Markdown

Les tableaux Markdown ne font pas partie de la spécification d'origine de Markdown ; ils proviennent du GitHub Flavored Markdown, le dialecte popularisé par GitHub et désormais pris en charge presque partout où les développeurs écrivent. La syntaxe est délibérément en texte brut : les colonnes sont séparées par la barre verticale, la ligne d'en-tête se place au sommet, et une deuxième ligne de tirets sépare l'en-tête du corps. Comme ce n'est que du texte, un tableau Markdown reste lisible sous sa forme brute et survit au copier-coller, aux diffs de gestion de versions et aux e-mails d'une manière qu'un tableau HTML ne pourrait jamais.

Cet outil retire toute la corvée d'alignement de ces barres verticales. Vous collez des lignes ordinaires, il détermine les colonnes, et il écrit un tableau correctement formé avec l'en-tête, la ligne de séparation et chaque cellule à sa place.

L'anatomie de la syntaxe

Un tableau minimal ressemble à trois lignes. La première ligne énumère les en-têtes séparés par des barres verticales, par exemple Nom, puis une barre verticale, puis Poste. La deuxième ligne est le séparateur : un groupe de tirets par colonne, comme trois tirets, une barre verticale, trois tirets. Chaque ligne suivante est une ligne de données utilisant le même motif de barres verticales. Les barres extérieures au début et à la fin de chaque ligne sont facultatives en GFM, mais les inclure rend le texte brut plus facile à lire, et c'est ce que produit ce générateur.

La ligne de séparation joue un double rôle : elle signale à la fois que la ligne du dessus est un en-tête et, par le placement des deux-points, déclare l'alignement de chaque colonne. C'est pourquoi un tableau Markdown a toujours besoin d'au moins une ligne d'en-tête et une ligne de séparation pour s'afficher.

Définir l'alignement des colonnes

L'alignement réside entièrement dans les tirets de la ligne de séparation, contrôlé par des deux-points. Un deux-points à gauche des tirets aligne la colonne à gauche, un deux-points des deux côtés la centre, et un deux-points à droite l'aligne à droite. Ainsi, une colonne centrée s'écrit avec un deux-points, quelques tirets, puis un deux-points, tandis qu'une colonne alignée à droite se termine par un deux-points. L'alignement à droite est le choix conventionnel pour les colonnes numériques, afin que les chiffres s'alignent par valeur de position.

Choisir Gauche, Centre ou Droite dans cet outil écrit ces marqueurs deux-points à votre place dans tout le tableau, ce qui signifie que l'alignement s'affiche de façon identique sur GitHub, dans les générateurs de documentation et dans tout autre lecteur GFM, sans dépendre des réglages du lecteur.

Un exemple concret

Collez trois lignes séparées par des virgules, Name, Role, City en haut, suivies de Ada Lovelace, Engineer, London et Grace Hopper, Admiral, New York. Avec l'alignement centré sélectionné, l'outil émet une ligne d'en-tête des trois titres, une ligne de séparation où les tirets de chaque colonne sont encadrés de deux-points, et deux lignes de données. Collé dans un README sur GitHub, il s'affiche comme un tableau soigné à trois colonnes aux valeurs centrées, sans avoir à compter manuellement les barres verticales.

Échapper les barres verticales et autres pièges

La barre verticale est le séparateur de colonnes, si bien qu'une barre verticale littérale à l'intérieur d'une cellule scinderait normalement cette cellule en deux et détruirait le tableau. Cet outil échappe automatiquement toute barre verticale présente dans vos données en l'écrivant sous la forme d'une barre oblique inverse suivie d'une barre verticale, de sorte qu'une valeur comme une expression logique contenant un symbole OU reste dans une seule cellule et s'affiche comme prévu.

Deux autres choses à savoir. Les tableaux Markdown ne peuvent pas contenir de sauts de ligne forcés à l'intérieur d'une cellule à l'aide de la touche Entrée ; si vous avez besoin d'un saut dans une cellule, vous insérez une balise br explicite, puisque le GFM autorise le HTML en ligne. Et chaque ligne doit comporter le même nombre de colonnes que l'en-tête. Les cellules en trop sur une ligne sont ignorées par la plupart des moteurs de rendu et les cellules manquantes s'affichent comme vides, alors gardez vos lignes rectangulaires pour des résultats prévisibles.

Séparateurs et valeurs entre guillemets

Les données réelles n'arrivent pas toujours séparées par des virgules. Laisser le séparateur sur Auto permet à l'outil de détecter si vos lignes utilisent des virgules, des tabulations ou des barres verticales, ce qui signifie qu'un bloc copié directement depuis un tableur (séparé par des tabulations) et un export CSV (séparé par des virgules) se convertissent tous deux sans configuration. Vous pouvez aussi forcer un séparateur précis lorsque la détection automatique se tromperait, comme pour des données qui contiennent légitimement beaucoup de virgules.

Les valeurs CSV entre guillemets sont également gérées correctement. Une virgule placée entre guillemets doubles est traitée comme faisant partie de la valeur, de sorte qu'un champ comme une entrée nom-de-famille-en-premier entre guillemets reste dans une seule cellule au lieu d'éclater en deux colonnes. C'est important, car les exports de tableur mettent systématiquement entre guillemets toute valeur contenant elle-même le délimiteur.

Où fonctionnent les tableaux Markdown, et où ils échouent

Les tableaux Markdown brillent dans les contextes de développement et de rédaction : les README, tickets et pull requests de GitHub et GitLab ; les générateurs de sites statiques et de documentation ; de nombreux wikis et applications de prise de notes ; les outils de discussion comme Slack et Discord dans leurs champs compatibles Markdown ; et les commentaires Reddit. Partout où le GFM est pris en charge, un tableau collé fonctionne tel quel et reste lisible sous sa forme source.

Ils ne sont toutefois pas universels. Le Markdown brut sans l'extension GFM ne comprend pas les tableaux, et certains moteurs de rendu légers les ignorent, auquel cas les barres verticales brutes apparaissent. Les tableaux Markdown manquent aussi de contrôle fin sur le style, de cellules fusionnées et de structure imbriquée. Lorsque vous avez besoin d'une mise en forme précise, de fusions de colonnes ou d'un style riche, un tableau HTML est le meilleur choix ; lorsque vous voulez un tableau propre, gérable en version et lisible par un humain, le Markdown l'emporte.