Pourquoi utiliser un générateur de tableau Markdown
Les tableaux Markdown sont du texte brut. Chaque ligne est une ligne de texte, les cellules sont séparées par des barres verticales et une ligne de séparation faite de tirets se trouve sous l’en-tête. C’est facile à lire mais long à taper, et garder les colonnes alignées à la main est fastidieux. Une valeur plus longue oblige à recompléter toutes les autres lignes.
Ce générateur de tableau Markdown vous donne une grille où taper, comme un petit tableur, et écrit le Markdown pour vous. Il lit aussi les données que vous avez déjà : cellules copiées depuis Excel ou Google Sheets, texte CSV ou tableau Markdown existant.
Comment utiliser la grille
- Tapez dans n’importe quelle cellule. La première ligne est l’en-tête et s’affiche en gras.
- Ajouter une ligne et Ajouter une colonne agrandissent le tableau. Les petits boutons x à côté de chaque ligne et au-dessus de chaque colonne les suppriment.
- Appuyez sur Entrée pour descendre d’une ligne. Sur la dernière ligne, Entrée en ajoute une nouvelle.
- Alignement : le menu au-dessus de chaque colonne règle Par défaut, Gauche, Centre ou Droite.
- Collez un bloc de cellules dans n’importe quelle cellule pour remplir la grille à partir de ce point.
- Coller des données ouvre une zone pour des cellules de tableur, du CSV ou un tableau Markdown. Appuyez sur Charger dans la grille pour remplacer la grille par ces données.
- Inverser lignes et colonnes fait pivoter le tableau.
- Exemple charge un exemple et Effacer repart d’une grille vide de 3 sur 3.
Le Markdown apparaît sous la grille. Aligner les colonnes complète chaque cellule pour que le tableau se lise bien en texte brut. Désactivez-le pour le résultat le plus court. Copier le met dans le presse-papiers et Télécharger enregistre un fichier .md.
Exemple
Un petit tableau de tarifs, première colonne alignée à gauche, prix alignés à droite et nombre d’utilisateurs centré :
| Plan | Price | Users |
| :------- | ----: | :-------: |
| Free | $0 | 1 |
| Team | $12 | 10 |
| Business | $30 | Unlimited |Les deux-points de la ligne de séparation règlent l’alignement : un deux-points à gauche aligne à gauche, à droite aligne à droite, des deux côtés centre. Avec Aligner les colonnes désactivé, le même tableau s’écrit sans remplissage :
| Plan | Price | Users |
| :-- | --: | :-: |
| Free | $0 | 1 |
| Team | $12 | 10 |
| Business | $30 | Unlimited |Les deux versions s’affichent de la même façon. La version alignée est plus facile à lire et à modifier dans un fichier texte. La version compacte est plus courte et donne des diffs plus petits quand une seule valeur change.
Pour des prix en euros à la française, comme 12 € ou 9,90 €, alignez la colonne à droite : le texte s’aligne sur le symbole, ce qui suffit pour une lecture rapide.
Les caractères spéciaux dans les cellules
Une barre verticale dans une cellule terminerait la cellule trop tôt, donc le générateur l’échappe. Un saut de ligne dans une cellule, qui peut venir d’un collage depuis un tableur, devient <br> :
| Command | Meaning |
| -------------- | ----------- |
| a \| b | pipe output |
| line1<br>line2 | two lines |Le reste du Markdown dans une cellule, comme **gras**, un lien ou du code en ligne, est gardé et s’affiche normalement. Les lettres accentuées comptent pour un caractère de large, donc les colonnes restent alignées avec du texte français.
Le remplissage compte les caractères chinois, japonais et coréens comme deux colonnes de large, car c’est ainsi qu’ils s’affichent dans la plupart des polices à chasse fixe. Les barres verticales restent ainsi alignées dans les éditeurs qui utilisent ces polices.
Où les tableaux Markdown fonctionnent
GitHub, GitLab, Bitbucket, Obsidian, Reddit et la plupart des générateurs de sites statiques acceptent cette syntaxe de tableau. Elle vient du GitHub Flavored Markdown. Le Markdown d’origine n’avait pas de tableaux, donc un moteur très ancien peut afficher les barres verticales brutes.
Conseils
- Gardez des tableaux étroits. Les longues phrases ont leur place dans des paragraphes. Un tableau de 3 à 6 colonnes courtes est le plus facile à lire sur téléphone.
- Partez d’un tableur quand les données s’y trouvent déjà. Copiez la plage, collez-la dans la première cellule et ajustez l’alignement.
- Pour ranger un tableau dans un document plus long, collez tout le document dans le formateur Markdown. Il aligne les tableaux de la même façon.
- Pour des données qui doivent finir en JSON plutôt qu’en tableau, utilisez le convertisseur CSV en JSON.
- Pour transformer un tableau HTML d’une page web en Markdown, utilisez le convertisseur HTML en Markdown.
Autres façons de créer des tableaux Markdown
- VS Code : des extensions comme Markdown All in One formatent les tableaux sur place quand vous formatez le document.
- Pandoc peut transformer un CSV ou un export de tableur en tableau Markdown en ligne de commande.
- Google Sheets : il n’y a pas d’export Markdown intégré, mais copier les cellules et les coller ici prend quelques secondes.
Tout se passe dans votre navigateur. Les données collées ne sont envoyées nulle part.