Comment convertir un tableau JSON en tableau HTML ou Markdown

À quoi sert JSON to Table ?

JSON to Table sert à transformer un tableau JSON placé au niveau supérieur en tableau lisible. Il convient notamment lorsque vous voulez présenter une liste de valeurs ou une série d’objets dans un document HTML ou Markdown, sans traiter un objet JSON isolé comme une table. Pour obtenir un résultat, le contenu fourni doit être un tableau JSON valide et non une valeur d’un autre type.

Convertir un tableau JSON en HTML ou en Markdown

1. Préparez un tableau JSON valide, par exemple une liste de valeurs ou une liste d’objets. Vérifiez que le premier niveau du contenu est bien entouré de crochets [ et ].

2. Collez le contenu dans la zone de saisie de l’outil. Une saisie vide, un texte JSON invalide ou une valeur qui n’est pas un tableau ne produit pas de tableau en sortie.

3. Choisissez le format de sortie souhaité : HTML, Markdown ou le format combiné lorsque vous avez besoin des deux représentations. Si aucun format n’est fourni, HTML est utilisé par défaut.

4. Lancez la conversion, puis récupérez la représentation générée. Pour une liste de valeurs simples, prévoyez une seule colonne. Pour une liste d’objets, les colonnes suivent l’ordre de première apparition des clés ; une clé absente d’un objet laisse une cellule vide.

5. Si vous choisissez Markdown, contrôlez l’affichage des valeurs contenant le caractère |. Celui-ci est échappé dans les cellules afin de ne pas perturber la structure du tableau. En HTML, les caractères ayant une signification particulière sont échappés dans le contenu du tableau.

Lire et vérifier le résultat

La forme du résultat dépend donc de la structure du tableau d’entrée. Une liste non vide composée de valeurs simples devient un tableau à une colonne. Une liste d’objets utilise les clés collectées dans l’ordre où elles apparaissent pour la première fois ; les propriétés manquantes sont rendues par des cellules vides. Avec le format combiné, le résultat contient une représentation HTML et une représentation Markdown.

Un tableau vide ne génère pas de tableau. Les tableaux mixtes, qui combinent objets et valeurs simples, doivent être lus avec prudence : les valeurs qui ne sont pas des objets sont placées uniquement dans la première colonne, tandis que les objets utilisent les colonnes issues de leurs clés. La représentation n’est donc pas rectangulaire pour chaque valeur.

Enfin, un cas très réduit comme [{}] peut produire des lignes Markdown sans ligne d’en-tête ni ligne de séparation, car aucune clé de colonne n’a été collectée. Cette limite concerne la structure du tableau obtenu, et non la validité générale du texte JSON.

Exemple pratique

Vous disposez d’une liste de deux objets, dont le premier contient « nom » puis « ville », tandis que le second contient seulement « nom », et vous souhaitez l’insérer dans une note Markdown.

Collez le tableau JSON, sélectionnez Markdown, puis lancez la conversion.

La sortie attendue est un tableau Markdown comportant les colonnes « nom » et « ville », dans cet ordre, avec une cellule vide pour la ville absente de la seconde ligne.

Limites

• Un tableau JSON vide ne produit pas de tableau.
• Dans un tableau mixte, les valeurs simples occupent uniquement la première colonne ; la représentation n’est pas entièrement rectangulaire pour chaque valeur.
• Lorsque aucune clé de colonne n’est collectée, Markdown peut afficher des lignes sans en-tête ni ligne de séparation.

Erreurs fréquentes

• Erreur : vous collez un objet JSON seul, du texte incomplet ou une saisie vide. Correction : fournissez un tableau JSON valide au niveau supérieur, avec des crochets, puis vérifiez la syntaxe avant de relancer la conversion.

Questions fréquentes

Comment une liste de valeurs est-elle convertie ?

Lorsque l’entrée est une liste non vide de valeurs simples, elle est présentée sous la forme d’un tableau à une seule colonne. Une liste vide ne produit pas de tableau.

Le résultat Markdown contient-il un en-tête ?

Lorsque vous sélectionnez Markdown pour une liste non vide avec au moins une clé de colonne, l’outil génère une ligne d’en-tête et une ligne de séparation. Le caractère | est échappé dans les cellules.

Que se passe-t-il avec un tableau JSON mixte ?

Lorsque le tableau mélange objets et valeurs simples, les valeurs simples apparaissent uniquement dans la première colonne et les objets utilisent les colonnes de leurs clés. Le résultat peut donc ne pas former une grille rectangulaire pour chaque ligne.