Ce que fait cet outil
Cet outil transforme des donnees CSV en un tableau Markdown que vous pouvez coller directement dans GitHub, la documentation d’un projet ou un README. Il utilise un editeur a deux volets : vous tapez ou collez vos lignes separees par des virgules a gauche et un tableau correctement mis en forme apparait a droite des que vous tapez, sans aucun bouton Convertir a presser. Si une ligne ne correspond pas a l’en-tete, un message en ligne le signale pour que vous puissiez le corriger, et quand le resultat vous convient vous pouvez le copier ou le telecharger en fichier .md. Il aide les developpeurs qui documentent une API, les redacteurs qui creent un tableau comparatif et toute personne qui prend des notes en Markdown et veut des tableaux soignes sans la syntaxe fastidieuse.
La premiere ligne de votre CSV est lue comme l’en-tete. Ces valeurs deviennent les titres des colonnes, une ligne de separation est inseree en dessous, et chaque ligne restante devient une ligne du tableau.
Comment l’utiliser
- Collez ou tapez votre CSV dans le volet de gauche, ou cliquez sur Charger un exemple pour inserer un echantillon. Placez les noms de colonnes sur la premiere ligne, par exemple
name,age, puis vos lignes de donnees en dessous, un enregistrement par ligne, commeAda,36. - Le tableau Markdown apparait dans le volet de droite instantanement pendant que vous tapez, il n’y a donc rien a cliquer pour convertir.
- Si une erreur en ligne apparait, comme une ligne au mauvais nombre de colonnes, corrigez la ligne signalee et le tableau se met a jour aussitot.
- Utilisez Copier pour recuperer le Markdown, ou Telecharger pour l’enregistrer en fichier
.md, puis collez-le dans votre README, votre issue, votre document ou votre commentaire. Effacer vide les deux volets quand vous voulez recommencer.
Un exemple rapide
Avec name,age sur la premiere ligne et Ada,36 sur la seconde, vous obtenez un tableau avec barres verticales : une ligne d’en-tete avec name et age, une ligne de separation faite de tirets, et une ligne de donnees avec Ada et 36. Un piege courant est une virgule egaree a l’interieur d’une valeur, car cela divise la cellule en deux colonnes, alors entourez ces valeurs avec soin ou nettoyez-les d’abord.
Cet outil fonctionne entierement dans votre navigateur. Il est prive, gratuit et ne necessite aucune inscription.
Questions fréquentes
- Comment le convertisseur utilise-t-il mon CSV ?
- La premiere ligne est traitee comme l'en-tete. Chaque valeur de cette ligne devient un titre de colonne, et chaque ligne en dessous devient une ligne du tableau. Une ligne de separation d'en-tete est ajoutee automatiquement pour que le resultat soit du Markdown valide.
- Ou puis-je coller le tableau Markdown ?
- Partout ou le Markdown est rendu, y compris les issues et pull requests GitHub, les fichiers README, GitLab, Reddit et la plupart des outils de sites statiques et de documentation. Collez simplement la sortie et elle s'affiche sous forme de tableau mis en forme.
- Dois-je cliquer sur quelque chose pour convertir ?
- Non. Le tableau se met a jour en direct dans le volet de droite des que vous tapez ou collez du CSV dans le volet de gauche, il n'y a donc aucun bouton Convertir a presser.
- Que se passe-t-il si mon CSV est mal forme ?
- L'outil affiche un message clair en ligne quand quelque chose ne va pas, par exemple une ligne comportant un nombre de colonnes different de l'en-tete. Corrigez la ligne signalee et le tableau se met a jour instantanement.
- Puis-je charger un exemple pour voir comment ca marche ?
- Oui. Le bouton Charger un exemple remplit la zone de saisie avec un petit CSV pret a l'emploi, pour que vous voyiez apparaitre le tableau Markdown tout de suite et partiez d'un exemple qui fonctionne.
- Puis-je copier ou telecharger le resultat ?
- Oui. Utilisez le bouton Copier pour placer le tableau Markdown dans le presse-papiers, ou le bouton Telecharger pour l'enregistrer en fichier .md. Un bouton Effacer vide les deux volets pour recommencer.
- Mon CSV est-il telecharge quelque part ?
- Non. Toute la conversion se fait dans votre navigateur avec JavaScript, donc vos donnees ne quittent jamais votre appareil. Cela le rend sur pour les exports prives et les listes internes.