Formater JSON : 3 méthodes fiables pour le rendre lisible et valide (Guide 2026)

Ce que « formater JSON » fait vraiment

Le JSON venu d’une API ou d’un fichier de log est souvent minifié : tout le document écrasé sur une seule ligne, sans espaces. C’est toujours du JSON valide, juste illisible. Formater (aussi appelé pretty-print ou embellir) l’étale à nouveau sur des lignes indentées pour révéler la structure : objets imbriqués, tableaux d’éléments, et où chacun se termine.

On le confond parfois avec la validation, et les deux vont souvent ensemble. La validation répond à « est-ce du JSON légal ? », le formatage à « un humain peut-il le lire ? ». Les bons formateurs font les deux en un passage : si votre JSON a une erreur de syntaxe, le formateur s’arrête et pointe la ligne au lieu de produire du bruit en silence.

Méthode 1 : formateur en ligne gratuit (le plus rapide)

Pour un besoin ponctuel — coller une réponse d’API ou un extrait de log — un outil en ligne est la voie la plus rapide : rien à installer, aucun code. Préférez un outil qui tourne entièrement dans votre navigateur (côté client) pour que vos données ne quittent jamais votre appareil ; c’est important si le JSON contient des jetons, des e-mails ou des données sensibles.

Collez votre JSON dans le formateur (ou déposez un fichier .json).
Cliquez sur Formater : l’outil applique l’indentation, colore la syntaxe et signale les erreurs avec leur numéro de ligne.
Copiez le résultat formaté dans votre éditeur, ou utilisez le bouton Minifier si vous avez besoin de la version compacte pour la production.

Méthode 2 : votre éditeur de code (l’habitude quotidienne)

Si vous touchez souvent au JSON, le formater dans l’éditeur prend une frappe. Dans VS Code, ouvrez le fichier .json et appuyez sur Maj+Alt+F (Windows/Linux) ou Maj+Option+F (Mac) — « Formater le document ». VS Code peut aussi formater à l’enregistrement si vous activez Éditeur : Format On Save.

La plupart des éditeurs ont besoin d’un plugin pour le travail JSON avancé, mais le formatage de base est intégré à VS Code, Sublime Text (via des paquets) et aux IDE JetBrains.

Méthode 3 : commande de terminal (reproductible)

Quand le JSON vit dans un fichier et que vous voulez le même résultat à chaque fois — dans un script, une étape de déploiement ou juste vite fait en ligne de commande — une ligne de commande bat les clics.

Terminal

# Afficher data.json formaté dans le terminal
python3 -m json.tool data.json

# Écrire la version formatée dans un nouveau fichier
python3 -m json.tool data.json > data.pretty.json

# Même idée avec jq, si vous l’avez installé
jq . data.json

python3 -m json.tool valide aussi : il quitte en erreur avec un numéro de ligne quand le fichier n’est pas du JSON valide, ce qui en fait un contrôle rapide dans les scripts.

Pretty-print vs minifié : quand utiliser quoi

Le JSON joliment formaté est pour les humains : débogage, fichiers de config édités à la main, exemples dans la doc. Le JSON minifié est pour les machines : réponses d’API, fichiers de production, tout ce qui exige moins d’octets et un parsing rapide.

Convertissez librement entre les deux — ce sont les mêmes données. Évitez juste d’éditer à la main la version minifiée : étalez-la d’abord, faites votre changement, puis minifiez à nouveau si le consommateur en a besoin.

Erreurs courantes révélées par le formatage

Neuf fois sur dix, un formateur qui « échoue » rend le plus grand service. Voici les coupables qu’il retrouve sans cesse :

Virgules finales — {"a": 1,} est illégal en JSON (valable en JavaScript). Supprimez la virgule avant le crochet fermant.
Guillemets simples — les chaînes JSON exigent des guillemets doubles. Remplacez 'valeur' par "valeur".
Commentaires — // et /* */ ne font pas partie de JSON. Supprimez-les, ou passez le fichier en JSONC/JSON5 si votre outil le gère.
Clés sans guillemets — {nom: "x"} doit devenir {"nom": "x"}.
Dégâts du copier-coller — les guillemets typographiques des applis de chat et des docs (« ») ne sont pas des guillemets valides ; remplacez-les par des guillemets droits.

Étape suivante : transformer votre JSON formaté en tableur

Une fois votre JSON lisible et valide, l’étape suivante est souvent de le passer dans un tableur — et c’est exactement ce que fait notre convertisseur gratuit : il aplatit votre JSON en CSV propre, prêt pour tableur, en quelques secondes, avec la même confidentialité sans envoi.

Lire : Comment convertir JSON en CSV

Guides associés

Questions fréquentes

Formater, est-ce la même chose que valider du JSON ?

Non, mais ça se recoupe. La validation vérifie que votre JSON respecte les règles de syntaxe ; le formatage le réécrit avec indentation et sauts de ligne pour que les humains le lisent. La plupart des formateurs valident d’abord — ils ne formatent pas un document avec une erreur de syntaxe, c’est pourquoi un formatage raté signifie généralement un JSON invalide.

Le formatage change-t-il mes données ?

Non. Le formatage ne change que les espaces : indentation, sauts de ligne et espaces. Clés, valeurs, ordre et types restent exactement identiques — sauf si vous activez explicitement des extras comme le tri des clés, que certains outils proposent en option séparée.

Que signifie « Unexpected token » lors du formatage ?

Ça veut dire que l’analyseur a rencontré un caractère qu’il ne peut pas placer — presque toujours une virgule finale, une chaîne entre guillemets simples, une clé sans guillemets ou un guillemet typographique collé depuis une appli de chat. Le message d’erreur inclut généralement une position ; corrigez cet endroit, reformatez, et l’erreur suivante (s’il y en a une) apparaîtra.

Puis-je formater du JSON sans rien installer ?

Oui. Utilisez un formateur en ligne gratuit qui tourne dans votre navigateur, ou la ligne python3 -m json.tool si Python est déjà sur votre machine. VS Code formate aussi les fichiers .json nativement avec Maj+Alt+F.

Est-il sûr de coller du JSON dans un formateur en ligne ?

En général oui, mais choisissez un formateur qui traite tout dans votre navigateur (côté client) — ainsi rien n’est envoyé nulle part. Si le JSON contient des clés d’API, des données personnelles ou quoi que ce soit que vous n’enverriez pas par e-mail, utilisez votre éditeur ou la commande de terminal.

Qu’est-ce que le JSON minifié ?

Du JSON dont tous les espaces inutiles ont été supprimés : tout le document sur une seule ligne. Les API et les fichiers de production l’utilisent parce qu’il est plus petit et s’analyse un peu plus vite. C’est du JSON valide — juste pas fait pour des yeux humains. N’importe quel formateur peut l’étendre à nouveau en version lisible.

Le formatage fonctionne-t-il sur d’énormes fichiers JSON ?

Oui, avec des limites. Les formateurs de navigateur gèrent bien quelques mégaoctets ; au-delà, ils peuvent figer l’onglet. Pour les gros fichiers, formatez en local avec python3 -m json.tool ou jq, qui traitent les gros fichiers sans broncher.