Générateur de tableaux Markdown
Modifiez un tableau dans une grille, ou collez-le depuis un tableur, un CSV ou un TSV, puis copiez-le en tableau Markdown GitHub aux colonnes bien alignées.
Fonctionne dans votre navigateur ; rien de ce que vous saisissez ne quitte votre appareil
Tableaux jusqu'à quelques milliers de cellules. Un tableau Markdown n'accepte qu'une ligne de texte par cellule : les sauts de ligne dans une cellule sont donc écrits <br> et les barres verticales sont échappées. La première ligne est toujours l'en-tête, comme l'exige GitHub.
Comment créer un tableau Markdown
- Saisissez dans la grille, ou collez-y directement des cellules copiées depuis un tableur. Vous pouvez aussi coller du CSV, du TSV ou un tableau Markdown existant dans la zone de texte et remplir la grille à partir de celui-ci.
- Ajoutez ou supprimez des lignes et des colonnes, et choisissez un alignement à gauche, centré ou à droite pour chaque colonne.
- Copiez le Markdown et collez-le dans votre README, ticket, pull request ou document.
Comment s'écrit un tableau Markdown
Un tableau Markdown GitHub est du texte brut : une ligne d'en-tête, une ligne de tirets qui définit l'alignement, puis une ligne par ligne de données, les cellules étant séparées par des barres verticales. C'est le format que GitHub affiche dans les README, les tickets et les pull requests, et de nombreux autres outils, dont les sites de documentation et les applications de notes, le comprennent aussi.
La grille contient les cellules ; la première ligne est l'en-tête. Chaque colonne a un alignement. La gauche s'écrit :---, le centre :---:, la droite ---: et l'absence d'alignement se note par de simples tirets. Le texte des cellules est échappé si nécessaire : une barre verticale devient \| et un saut de ligne devient la balise HTML <br>. L'outil aligne ensuite les colonnes avec des espaces pour que le source ressemble à un tableau, en se fondant sur la largeur de chaque caractère plutôt que sur son nombre d'octets, afin que les lettres accentuées s'alignent aussi.
Coller depuis un tableur est le moyen le plus rapide de démarrer. Les tableurs placent les cellules copiées dans le presse-papiers sous forme de texte séparé par des tabulations, avec une ligne par ligne du tableau, et la grille le lit directement. Les fichiers CSV et TSV fonctionnent de la même façon via la zone de texte, avec prise en charge des champs entre guillemets et des sauts de ligne entre guillemets. Si vous collez un tableau Markdown existant, les cellules et les alignements sont relus dans la grille pour que vous puissiez les modifier.
Conseils
- Vous avez du JSON plutôt qu'un tableur ? Convertissez-le d'abord avec JSON en CSV, puis collez le résultat ici.
- Voyez le rendu du tableau avec Markdown en HTML.
- Pour faire l'inverse, d'une page web vers du Markdown, utilisez HTML en Markdown.
Questions fréquentes
Comment transformer un tableur en tableau Markdown ?
Sélectionnez les cellules dans Excel, Google Sheets ou Numbers, copiez-les et collez-les dans n'importe quelle cellule de la grille. Les cellules d'un tableur arrivent sous forme de texte séparé par des tabulations, et la grille se remplit à partir de la cellule où vous avez collé. Vous pouvez aussi coller du CSV ou du TSV dans la zone au-dessus de la grille et choisir Remplir la grille avec ce texte.
Comment fonctionnent les alignements de colonnes ?
La ligne de tirets sous l'en-tête définit l'alignement : :--- correspond à gauche, :---: au centre, ---: à droite et --- à l'alignement par défaut. Choisissez l'alignement de chaque colonne au-dessus de sa cellule d'en-tête.
Que devient une barre verticale ou un saut de ligne dans une cellule ?
Une barre verticale | terminerait la cellule, elle est donc écrite \|. Les tableaux Markdown ne peuvent pas contenir de vrais sauts de ligne : un saut de ligne dans une cellule est écrit <br>, que GitHub affiche comme un retour à la ligne.
Pourquoi les colonnes sont-elles complétées par des espaces ?
Le remplissage aligne les colonnes pour que le tableau se lise facilement en texte brut. Il ne change rien à l'affichage final. Décochez Aligner les colonnes pour obtenir la forme la plus courte.
Puis-je modifier un tableau Markdown existant ?
Oui. Collez-le dans la zone de texte et choisissez Remplir la grille avec ce texte. L'outil lit les cellules et les alignements et les place dans la grille.
Mon tableau est-il envoyé quelque part ?
Non. Le tableau est construit dans votre navigateur et rien ne quitte votre appareil.