Mode d’emploi
- Saisissez l’en-tête dans la première ligne et les données en dessous, ou ouvrez « Remplir depuis un CSV… » et collez des cellules d’un tableur.
- Ajoutez ou supprimez des lignes et des colonnes avec les boutons.
- Définissez l’alignement de chaque colonne avec le menu situé au-dessus.
- Choisissez Markdown ou HTML, puis copiez ou téléchargez le tableau.
Fonctionnement
La sortie Markdown suit la syntaxe de tableau de GitHub Flavored Markdown (GFM), prise en charge par GitHub, GitLab, de nombreux générateurs de documentation et la plupart des éditeurs Markdown. La première ligne devient l’en-tête, suivie de la ligne de délimitation qui définit l’alignement : :--- pour gauche, :---: pour centre, ---: pour droite et --- pour la valeur par défaut.
Le contenu des cellules est échappé afin qu’il ne puisse pas casser le tableau : un | dans une cellule est écrit \|, et un saut de ligne devient <br>, car une ligne de tableau GFM doit tenir sur une seule ligne. Les autres éléments Markdown dans les cellules, comme **gras** ou `code`, sont conservés et seront rendus par le lecteur Markdown. Avec « Aligner les colonnes avec des espaces », chaque colonne est complétée à la même largeur afin que le tableau reste lisible en texte brut ; les caractères comme le chinois, le japonais ou le coréen occupent deux colonnes de large. Les lignes ayant moins de cellules sont complétées avec des cellules vides.
L’import accepte le texte séparé par des tabulations (ce que les tableurs placent dans le presse-papiers), le CSV avec des virgules ou des points-virgules, y compris les champs entre guillemets contenant des virgules, des guillemets et des sauts de ligne, ainsi que les tableaux Markdown existants, dont la ligne d’alignement est également lue.
La sortie HTML est un simple <table> avec <thead> et <tbody>. Le texte est échappé pour HTML (& < > "), les sauts de ligne deviennent <br>, et l’alignement est défini par des styles text-align en ligne afin que cela fonctionne sans feuille de style.
Exemples
Du tableur vers README
Sélectionnez une plage dans Google Sheets, copiez-la, collez-la dans la zone d’import et cliquez sur « Remplir le tableau ». Alignez la colonne des prix à droite et copiez le Markdown dans README.md.
Texte avec une barre verticale
Une cellule contenant « Unlimited | fair use » est écrite sous la forme Unlimited \| fair use, afin que GitHub affiche la barre verticale au lieu de créer une nouvelle colonne.
Nettoyer un tableau existant
Collez un tableau Markdown écrit à la main avec un espacement irrégulier, cliquez sur « Remplir le tableau » et recopiez le résultat avec toutes les colonnes alignées et l’alignement conservé.
Foire aux questions
Une cellule peut-elle contenir un saut de ligne ?
Pas comme un vrai saut de ligne, car chaque ligne de tableau doit être une seule ligne en Markdown. Le générateur écrit <br> à la place ; GitHub et la plupart des lecteurs l’affichent comme un saut de ligne.
Pourquoi faut-il une ligne d’en-tête ?
Les tableaux GFM commencent toujours par une ligne d’en-tête suivie de la ligne d’alignement. Si vous ne voulez pas de titres visibles, vous pouvez laisser les cellules d’en-tête vides, mais la plupart des lecteurs affichent quand même la ligne d’en-tête.
Puis-je fusionner des cellules ?
Non. Les tableaux Markdown ne prennent pas en charge les cellules fusionnées (colspan ou rowspan). Si vous en avez besoin, utilisez la sortie HTML et ajoutez les attributs colspan ou rowspan manuellement.
L’ajout d’espaces modifie-t-il l’apparence du tableau une fois rendu ?
Non. Les espaces supplémentaires sont ignorés lors du rendu du Markdown. L’ajout d’espaces ne fait que rendre le code source plus lisible et plus facile à modifier.
Confidentialité
Le tableau est créé uniquement dans votre navigateur. Les données que vous saisissez ou collez ne sont ni envoyées, ni stockées, ni incluses dans les statistiques.