Convertir un JSON ou un CSV en tableau Markdown

À quoi sert le convertisseur JSON ou CSV vers Markdown ?

Ce convertisseur sert à transformer un contenu JSON ou CSV en texte de tableau Markdown, afin de le réutiliser dans une documentation, un fichier README ou une page qui accepte ce format. Le contenu à traiter est fourni sous forme de texte. La conversion produit un tableau lorsque les données respectent la structure attendue et que le traitement aboutit.

Procédure de conversion

1. Préparez le contenu à convertir. Choisissez le format json pour des données JSON ou csv pour des lignes séparées par des retours à la ligne et des champs séparés par des virgules. Un contenu vide ne permet pas de produire un tableau.

2. Collez le texte dans la zone de données, puis indiquez le format correspondant. Pour un JSON non vide adapté à une structure de lignes, les clés de la première ligne servent d’en-têtes si vous ne fournissez pas d’en-têtes personnalisés. Un objet JSON non vide est traité comme une seule ligne.

3. Si nécessaire, saisissez vos en-têtes personnalisés sous forme de liste séparée par des virgules. Les espaces autour de chaque en-tête sont retirés lors du traitement. Pour un CSV sans en-têtes personnalisés, la première ligne devient la ligne d’en-têtes et les lignes suivantes deviennent les données.

4. Choisissez l’alignement des colonnes : gauche, centre ou droite. L’alignement à gauche est utilisé par défaut. Lancez ensuite le traitement et récupérez le texte du tableau Markdown généré.

Comprendre le résultat et ses limites

Le résultat attendu est un texte contenant la structure d’un tableau Markdown, avec une ligne d’en-têtes, des marqueurs d’alignement et les lignes de données lorsque le traitement réussit. Un JSON vide, notamment une liste vide, un objet vide, null, false, 0 ou une chaîne vide, produit un résultat de tableau vide plutôt qu’un tableau rempli.

Un JSON mal formé échoue pendant le traitement. D’autres structures JSON valides peuvent aussi échouer si elles ne fournissent pas la structure de lignes attendue. Pour le CSV, les lignes et les champs sont séparés directement sur les retours à la ligne et les virgules : les conventions avancées, comme les virgules protégées dans des champs entre guillemets, ne sont pas établies. Les champs CSV excédant le nombre d’en-têtes sont écartés et les champs manquants donnent des valeurs vides.

Exemple pratique

Vous disposez d’un objet JSON non vide représentant une ligne avec les clés « produit » et « quantité », et vous voulez l’insérer dans un README sous forme de tableau Markdown.

Choisissez le format JSON, collez le contenu, puis lancez le traitement sans en-têtes personnalisés ni alignement personnalisé.

Le résultat attendu est un texte de tableau Markdown comprenant une ligne d’en-têtes, une ligne de séparation et une ligne pour chaque enregistrement conservé.

Limites

• Le traitement CSV sépare directement les lignes et les champs sur les retours à la ligne et les virgules ; les conventions avancées du format CSV ne sont donc pas établies.

Erreurs fréquentes

• Un format non pris en charge, un contenu absent ou un JSON mal formé empêche la conversion. Sélectionnez json ou csv, fournissez un contenu non vide et vérifiez la syntaxe JSON avant de relancer le traitement.

Questions fréquentes

Peut-on convertir n’importe quel JSON en tableau Markdown ?

Oui, si le JSON est non vide et fournit une structure de lignes compatible. Sans en-têtes personnalisés, les clés de la première ligne servent d’en-têtes ; certaines structures JSON valides peuvent toutefois échouer au traitement.

Comment les en-têtes d’un CSV sont-ils déterminés ?

Pour un CSV sans en-têtes personnalisés, la première ligne fournit les en-têtes et les lignes suivantes fournissent les données.

Quels alignements peut-on utiliser ?

Les choix pris en charge sont gauche, centre et droite, avec un alignement à gauche par défaut. Une valeur différente revient aux marqueurs d’alignement à gauche.