À quoi ça sert
Les réponses d’API, les exports et la configuration arrivent souvent en JSON, mais un tableau se lit bien mieux dans un README, une pull request, un wiki ou un message de chat. Cet outil transforme un tableau JSON d’objets en tableau GitHub Flavored Markdown qui s’affiche sur GitHub, GitLab, Notion, Obsidian et la plupart des sites de documentation.
Chaque objet devient une ligne et chaque clé une colonne. Les objets imbriqués sont aplatis en noms de colonnes à points, les barres verticales et retours à la ligne des valeurs sont échappés, et les colonnes sont complétées par des espaces pour que le Markdown brut soit lui aussi aligné.
Mode d’emploi
- Collez le JSON, importez un fichier
.jsonou cliquez sur Exemple. - Choisissez l’Alignement : par défaut, gauche, centré, droite, ou Nombres à droite pour aligner à droite les colonnes qui ne contiennent que des nombres.
- Laissez Aplatir les objets imbriqués activé pour répartir les champs imbriqués sur plusieurs colonnes, ou désactivez-le pour les afficher en JSON.
- Désactivez Aligner les colonnes si vous préférez des lignes compactes sans remplissage.
- Copiez le tableau ou téléchargez-le en fichier
.md.
Si le JSON est invalide, l’erreur indique la ligne et la colonne pour le corriger rapidement.
Exemple
Ce JSON :
[
{ "name": "ripgrep", "stars": 48000, "repo": { "owner": "BurntSushi" } },
{ "name": "fd", "stars": 34000, "repo": { "owner": "sharkdp" }, "tags": ["find"] }
]devient ce tableau Markdown :
| name | stars | repo.owner | tags |
| ------- | ----- | ---------- | -------- |
| ripgrep | 48000 | BurntSushi | |
| fd | 34000 | sharkdp | ["find"] |L’objet imbriqué repo devient la colonne repo.owner, le tableau tags est écrit en JSON et la première ligne a une cellule vide car elle n’a pas de tags.
Astuces
- Les valeurs sont écrites comme du texte : nombres et booléens apparaissent tels quels et
nulldevient une cellule vide. - Les tableaux très larges sont difficiles à lire ; supprimez les champs inutiles avant la conversion.
- Le Markdown en ligne des valeurs texte, comme
**gras**ou les liens, est conservé et rendu par la plupart des visionneuses. - Pour des données CSV, ou pour produire un tableau HTML, utilisez les outils associés ci-dessous.
FAQ
› Quelles structures JSON sont prises en charge ?
Un tableau d’objets donne une ligne par objet, avec une colonne pour chaque clé présente dans au moins un objet. Un objet seul donne un tableau à deux colonnes Key / Value. Un tableau de tableaux donne des lignes avec des colonnes numérotées, et un tableau de valeurs simples une seule colonne Value.
› Comment les objets imbriqués sont-ils traités ?
Avec Aplatir les objets imbriqués activé, les champs imbriqués deviennent des colonnes à points, comme address.city. Les tableaux sont écrits en JSON compact dans la cellule. Désactivez l’aplatissement pour garder chaque objet imbriqué en JSON dans une seule cellule.
› Et si les objets n’ont pas les mêmes clés ?
L’en-tête est l’union de toutes les clés, dans l’ordre de leur première apparition. Une cellule reste vide quand un objet n’a pas cette clé, et les valeurs null s’affichent aussi comme des cellules vides.
› Mon JSON est-il envoyé quelque part ?
Non. L’analyse et la conversion se font entièrement dans votre navigateur : les réponses d’API et les données privées ne quittent jamais votre appareil.