Trois modes de rendu
Les tableaux JSON d’objets se rendent mieux sous forme de tableaux Markdown : l’outil extrait les en-têtes de colonnes de l’union de toutes les clés, puis écrit une ligne délimitée par des pipes par objet. L’ordre des colonnes suit le premier objet par défaut, avec les clés supplémentaires ajoutées à la fin. Les valeurs booléennes et null sont rendues en littéraux "true", "false" et "null" pour que chaque cellule contienne du texte imprimable.
Les JSON imbriqués — objets dans des objets, tableaux mixtes — se rendent sous forme de listes à puces indentées. Chaque clé devient une puce-titre et sa valeur une puce-enfant. Les tableaux de primitives deviennent des listes inline compactes ou des puces multi-lignes selon la longueur. Ce mode est idéal pour les dumps de configuration, la documentation de réponses API et les entrées de changelog.
Le mode bloc de code enveloppe le JSON dans un bloc clôturé ``` json ``` avec des indications de coloration syntaxique. Il utilise la forme pretty-print (indentation 2 espaces) pour que la sortie soit immédiatement lisible dans tout moteur Markdown. C’est le moyen le plus rapide d’intégrer un exemple JSON dans un README ou une page wiki.
Options de tableau et cas limites
Lors de la génération de tableaux, les colonnes peuvent être triées alphabétiquement ou dans l’ordre de découverte des clés (par défaut). Vous pouvez aussi épingler des colonnes spécifiques à gauche — utile quand une clé comme "id" ou "name" doit toujours être la première colonne. Les cellules contenant des caractères pipe sont automatiquement échappées avec une barre oblique inverse pour ne pas casser le tableau.
Les objets imbriqués dans une cellule de tableau sont sérialisés en chaîne JSON inline compacte. Cela préserve toutes les données au détriment de la lisibilité pour les valeurs profondément imbriquées. Alternativement, activez l’option "aplatir avant rendu" pour utiliser des clés en notation pointée comme colonnes de premier niveau.
Les tableaux de types mixtes — où certains éléments sont des objets et d’autres des primitives — basculent gracieusement vers le rendu en liste car un jeu uniforme de colonnes ne peut pas être dérivé. L’outil choisit toujours la sortie la plus lisible pour la forme des données.
Flux de travail pour la documentation et les rapports
La documentation d’API nécessite fréquemment de transformer des exemples de réponses JSON en tableaux lisibles. Collez le JSON de la réponse, passez en mode tableau et copiez le Markdown directement dans votre plateforme de documentation — Notion, Confluence, GitHub Wiki ou un simple README.
Les analystes de données reçoivent souvent des rapports JSON d’API ou de bases de données et doivent partager des résultats avec des parties prenantes non techniques. La conversion en tableau Markdown rend les données immédiatement lisibles dans tout outil de chat, e-mail ou générateur de site statique supportant le Markdown.
Les documents d’onboarding développeur, les références de configuration et les guides de migration bénéficient tous de tableaux Markdown générés automatiquement plutôt que formatés manuellement. Le convertisseur assure la cohérence et fait gagner du temps quand les données sous-jacentes changent.