ViewCSVOuvrez ou collez un fichier CSV : un tableau à barres verticales s’affiche à côté des options, prêt pour un README, un ticket ou une page de wiki. Un | à l’intérieur d’une valeur est écrit \| pour ne jamais couper une cellule, les sauts de ligne dans une cellule deviennent <br>, et les colonnes de nombres sont alignées à droite. La conversion a lieu dans votre navigateur, sans jamais envoyer le fichier.
Convertir un CSV en Markdown, étape par étape
- Cliquez sur Ouvrir un fichier, déposez un fichier
.csv,.tsvou.txtsur l’outil, ou choisissez Coller. Le séparateur est détecté ; si la détection se trompe, réglez-le, ainsi que l’encodage ou La première ligne contient les en-têtes, dans Paramètres d’importation. - Choisissez l’Alignement des colonnes et la façon d’écrire les Retours à la ligne dans les cellules. L’onglet Markdown montre le texte exact que contiendra le téléchargement.
- Choisissez Copier pour coller le tableau directement dans GitHub, GitLab ou votre éditeur, ou Télécharger en Markdown pour enregistrer un fichier
.md.
Si votre fichier n’a pas de ligne d’en-têtes, désactivez La première ligne contient les en-têtes : un tableau Markdown a toujours besoin d’un en-tête, les colonnes sont donc nommées Column 1, Column 2, et ainsi de suite. Pour afficher les mêmes données sous forme de tableau web, utilisez CSV en HTML.
Ce que fait chaque option
| Nombres à droite, texte par défaut | Le réglage par défaut. Une colonne n’est alignée à droite (---:) que si toutes ses valeurs non vides sont des nombres simples ; avec 00731 ou 12 kg, la colonne garde l’alignement par défaut du moteur de rendu. |
|---|---|
| Par défaut (aucun), Gauche, Centré, Droite | Applique un même alignement à toutes les colonnes : ---, :---, :---: ou ---: dans la ligne de séparation. |
| Conserver en <br> | Un saut de ligne dans une cellule devient <br>, que GitHub et la plupart des moteurs de rendu affichent comme un retour à la ligne dans la cellule. C’est le réglage par défaut. |
| Remplacer par une espace | Chaque saut de ligne devient une espace, pour les moteurs de rendu qui suppriment le HTML. |
| Échapper les caractères Markdown | Activé par défaut. *, _, [, ], <, >, #, ~ et l’accent grave (backtick) reçoivent une barre oblique inverse : une valeur comme *fast* ou <b> s’affiche telle qu’elle a été saisie, au lieu de devenir de la mise en forme ou du HTML. Ne le désactivez que si les cellules contiennent du Markdown que vous voulez voir interprété. |
| Aligner les colonnes dans le texte source | Activé par défaut. Complète les cellules par des espaces pour que le fichier .md brut se lise comme une grille. Les caractères larges, comme le chinois, le japonais ou le coréen, comptent pour deux colonnes. Désactivez-le pour obtenir le résultat le plus compact ; le tableau affiché reste identique. |
Comment les données délicates sont traitées
- Les barres verticales et les barres obliques inverses sont toujours échappées (
\|,\\), même quand Échapper les caractères Markdown est désactivé, car un|non échappé ouvrirait une nouvelle cellule. - Les virgules et les sauts de ligne entre guillemets sont lus selon la RFC 4180 :
"Cable tidy, 3-pack"reste dans une seule cellule. Un avertissement au-dessus de l’aperçu compte les valeurs qui contenaient un saut de ligne. - Les valeurs sont écrites en texte :
00731garde ses zéros et34.90son zéro final. Rien n’est arrondi ni reformaté. - Un en-tête vide devient
Column 3et un en-tête répéténame (2): chaque colonne a ainsi un titre distinct. - Les moteurs de rendu Markdown suppriment les espaces au début et à la fin d’une cellule, et un tableau ne peut contenir ni listes ni paragraphes ; gardez ce type de contenu dans un document séparé.
En cas de problème
- Le texte qui suit le tableau rejoint sa dernière ligne. Un tableau ne se termine qu’à une ligne vide ou au début d’un autre bloc : laissez une ligne vide après lui.
- Toutes les valeurs sont dans une seule colonne. Le séparateur a été mal deviné. Choisissez Virgule, Point-virgule, Tabulation ou Barre verticale dans les paramètres d’importation et rouvrez le fichier.
- **Des barres obliques inverses apparaissent devant * ou _ dans le rendu.** C’est l’échappement, affiché par un moteur de rendu qui ne l’interprète pas. Désactivez l’échappement des caractères Markdown si vos données ne contiennent pas de caractères de mise en forme à protéger.
- Les sauts de ligne s’affichent sous forme de balise. Le moteur de rendu n’autorise pas le HTML. Choisissez Remplacer par une espace pour les retours à la ligne dans les cellules.
Limites et confidentialité
Les fichiers jusqu’à 25 Mo, 100 000 lignes ou 2 millions de cellules s’ouvrent avec un aperçu en direct des 200 premières lignes. Les fichiers plus gros sont convertis en flux : le fichier est lu deux fois par morceaux (une fois pour mesurer les colonnes et leur largeur, une fois pour écrire), un avertissement précise que le téléchargement couvre tout le fichier, et Copier n’est pas proposé. Un fichier produit est plafonné à 4 Go.
La conversion s’exécute dans un worker en arrière-plan, dans cet onglet : la page reste réactive et Annuler l’interrompt. Le CSV n’est jamais envoyé sur un serveur. Pour examiner un gros fichier avant de le convertir, ouvrez-le dans le lecteur CSV.
Exemple
Une liste de produits avec une référence SKU à zéro initial, une barre verticale dans un nom, une virgule entre guillemets et une note sur deux lignes, convertie avec les réglages par défaut. price est alignée à droite parce que toutes ses valeurs sont des nombres ; sku ne l’est pas, car 00731 est conservé en texte.
sku,name,price,note 00731,"Desk lamp | brass",34.90,"Ships in 2 days from Leeds" 00732,"Cable tidy, 3-pack white",4.50,Back-ordered until 14 March 2025 00733,USB-C hub,129.00,
| sku | name | price | note | | ----- | ------------------------ | -----: | -------------------------------- | | 00731 | Desk lamp \| brass | 34.90 | Ships in 2 days<br>from Leeds | | 00732 | Cable tidy, 3-pack white | 4.50 | Back-ordered until 14 March 2025 | | 00733 | USB-C hub | 129.00 | |
Questions fréquentes
Le résultat fonctionne-t-il sur GitHub ?
Oui. C’est un tableau à barres verticales au format GitHub Flavored Markdown : une ligne d’en-têtes, une ligne de séparation avec deux-points d’alignement facultatifs, puis une ligne par ligne du CSV. GitLab, Obsidian et la plupart des générateurs de sites statiques lisent la même syntaxe.
Pourquoi vois-je `\|` dans le texte source ?
Dans un tableau Markdown, un | simple termine une cellule. La barre oblique inverse indique au moteur de rendu d’afficher la barre comme du texte : Desk lamp | brass reste ainsi dans une seule cellule.
Puis-je reconvertir un tableau Markdown en CSV ?
Pas sur cette page. Elle convertit uniquement du CSV et du TSV en Markdown.