À quoi ça sert
Écrire des tableaux Markdown à la main est fastidieux : chaque ligne demande des barres verticales, la deuxième ligne des tirets, et aligner les colonnes prend un temps fou. Cet outil convertit des données CSV ou TSV en tableau GitHub Flavored Markdown à coller dans un README, une pull request, une issue, un wiki ou toute documentation en Markdown.
Le CSV est analysé correctement : champs entre guillemets contenant des virgules, guillemets doublés et cellules sur plusieurs lignes sont gérés. La sortie est complétée par des espaces pour que les colonnes restent alignées en texte brut, ce qui facilite la lecture et les modifications ultérieures.
Mode d’emploi
- Collez du CSV ou du TSV, importez un fichier
.csvou.tsv, ou cliquez sur Exemple. - Choisissez l’Alignement : par défaut, gauche, centré, droite, ou Nombres à droite pour aligner à droite les colonnes qui ne contiennent que des nombres.
- Laissez La première ligne est l’en-tête activé si la première ligne contient les noms de colonnes ; sinon l’en-tête sera Column 1, Column 2, etc.
- Désactivez Aligner les colonnes si vous préférez des lignes compactes sans remplissage.
- Copiez le tableau ou téléchargez-le en fichier
.md.
Les lignes qui ont moins de cellules que l’en-tête sont complétées par des cellules vides : le tableau est donc toujours valide.
Exemple
Ce CSV :
Tool,Stars,Notes
ripgrep,48000,"Fast, recursive search"
fd,34000,find | but friendlierdevient ce tableau Markdown avec l’alignement Nombres à droite :
| Tool | Stars | Notes |
| ------- | ----: | ---------------------- |
| ripgrep | 48000 | Fast, recursive search |
| fd | 34000 | find \| but friendlier |La virgule du champ entre guillemets reste dans la cellule, la barre verticale est échappée et la colonne numérique reçoit le marqueur --: pour être alignée à droite au rendu.
Astuces
- Les marqueurs d’alignement de la deuxième ligne (
:--,:-:,--:) déterminent l’alignement de chaque colonne dans le tableau rendu. - Le Markdown en ligne dans les cellules, comme
**gras**, le code en ligne ou les liens, est conservé et rendu par la plupart des visionneuses. - Les tableaux très larges sont difficiles à lire sur petit écran ; pensez à répartir les colonnes sur plusieurs tableaux.
- Pour produire un tableau HTML, ou transformer un tableau JSON en tableau Markdown, utilisez les outils associés ci-dessous.
FAQ
› Quelle variante de Markdown le tableau utilise-t-il ?
Les tableaux à barres verticales de GitHub Flavored Markdown (GFM), aussi pris en charge par GitLab, Bitbucket, Notion, Obsidian, Docusaurus, MkDocs et la plupart des générateurs de sites statiques. Le CommonMark pur n’a pas de syntaxe de tableau.
› Que deviennent les barres verticales et les retours à la ligne dans les cellules ?
Une barre verticale fermerait la cellule : elle est donc écrite \|. Les retours à la ligne sont interdits dans une ligne de tableau ; ils deviennent des balises <br>, que GitHub et la plupart des moteurs de rendu affichent comme un retour à la ligne.
› Pourquoi les colonnes en chinois, japonais ou coréen sont-elles alignées ?
Avec Aligner les colonnes activé, les cellules sont complétées selon la largeur d’affichage : les caractères larges d’Asie de l’Est comptent pour deux colonnes, ce qui garde le Markdown aligné dans un éditeur à police à chasse fixe. Le tableau rendu est identique dans les deux cas.
› Puis-je convertir du TSV copié depuis Excel ou Google Sheets ?
Oui. Les cellules copiées depuis un tableur sont séparées par des tabulations, et le délimiteur est détecté automatiquement. Vous pouvez aussi choisir Tabulation explicitement.