Pourquoi le TOML pour la configuration
Le TOML a été conçu comme un format de configuration évident et minimal : des paires clé = valeur, des [sections] pour regrouper, et des commentaires avec #. Cargo pour Rust, pyproject.toml pour Python, Hugo, Netlify et bien d'autres outils l'utilisent.
Ce convertisseur traduit les objets JSON en tables TOML et les tableaux d'objets en tableaux de tables, garde l'ordre des clés et écrit les valeurs avec les bons guillemets. Le TOML n'ayant pas de null, les valeurs null sont omises au lieu de produire un fichier invalide.
JSON ou TOML : comparaison rapide
| Caractéristique | JSON | TOML |
|---|---|---|
| Nom complet | JavaScript Object Notation | Tom's Obvious, Minimal Language |
| Type | Données hiérarchiques | Données de configuration |
| Création | Début des années 2000 (RFC 4627 en 2006) | 2013 |
| Créé par | Douglas Crockford ; aujourd'hui ECMA-404 et RFC 8259 | Tom Preston-Werner |
| Structure | Objets et tableaux imbriqués | Paires clé/valeur regroupées en [tables] |
| Commentaires | Non | Oui, avec # |
| Types de données | Chaîne, nombre, booléen, null, objet, tableau | Chaîne, entier, flottant, booléen, date, tableau, table ; pas de null |
| Idéal pour | API, applications web et réglages d'applis | Configuration de projets comme Cargo.toml et pyproject.toml |
| Compatibilité | Tous les langages de programmation | Rust, Python, Go et la plupart des langages via des bibliothèques |
| Type MIME | application/json | application/toml |
Comment convertir du JSON en TOML
Étape 1: Sélectionnez un fichier JSON
Déposez le fichier .json de configuration ou de données dans le convertisseur.
Étape 2: TOML est présélectionné
Laissez TOML comme sortie.
Étape 3: Convertissez
Les objets deviennent des tables, les tableaux des tableaux TOML, et les null sont retirés.
Étape 4: Téléchargez le fichier .toml
Ajoutez des commentaires et placez-le dans votre projet.
Correspondance entre JSON et TOML
Tables
Les objets imbriqués deviennent des tables [section] et [section.sous].
Tableaux de tables
Les tableaux d'objets deviennent des blocs [[section]].
Gestion des null
Les valeurs null sont retirées, le TOML ne pouvant pas les représenter.
Tableaux de premier niveau
Un tableau JSON est placé sous une clé items, le TOML exigeant une table à la racine.
Où le JSON vers TOML est pratique
Projets Rust. Rédigez des sections de Cargo.toml à partir de données JSON.
Packaging Python. Déplacez des réglages dans pyproject.toml.
Générateurs de sites statiques. Hugo et Zola lisent une configuration TOML.
Réglages lisibles. Offrez à vos utilisateurs un fichier de configuration commentable.
Ce que le TOML ne sait pas exprimer
Le TOML n'a pas de valeur null : les clés à null sont supprimées. Les tableaux TOML 1.0 peuvent mélanger les types, mais certains anciens analyseurs refusent les tableaux mixtes ; gardez des tableaux homogènes si votre outil est strict.
Le JSON n'a pas de type date : les dates de votre JSON sont donc écrites en chaînes entre guillemets. Si votre outil attend de vraies dates TOML, retirez les guillemets après la conversion.
- "timeout": null est supprimé.
- "started": "2026-09-17" reste une chaîne entre guillemets.
- [1, 2, 3] reste un tableau en ligne.
Lire le résultat
Les valeurs simples de premier niveau apparaissent d'abord, suivies des tables. Les objets imbriqués sont écrits avec des en-têtes de table à points comme [server.tls], ce qui est du TOML standard.
Les clés contenant des espaces, des points ou d'autres caractères spéciaux sont mises entre guillemets pour que le fichier s'analyse correctement.
Conseils pour le JSON vers TOML
- Remplacez les null par des valeurs par défaut avant la conversion si les clés doivent exister.
- Vérifiez le résultat avec l'outil qui le lira ; chaque outil attend ses propres clés.
- Ajoutez des commentaires au-dessus des tables pour expliquer les réglages.
- Utilisez TOML vers JSON pour vérifier l'aller-retour.
Questions sur la conversion JSON en TOML
Que deviennent les valeurs null ?
Elles sont supprimées, le TOML n'ayant pas de type null.
La racine du JSON peut-elle être un tableau ?
Oui. Elle est placée sous une clé items, car un document TOML doit être une table.
Comment les tableaux d'objets sont-ils écrits ?
Sous forme de tableaux de tables avec des doubles crochets, comme [[items]].
L'ordre des clés est-il conservé ?
Oui, dans le respect des règles du TOML, où les valeurs simples précèdent les tables.
Quelle version de TOML est produite ?
TOML 1.0, écrit avec la bibliothèque smol-toml.
Mon fichier est-il envoyé ?
Non. La conversion a lieu dans votre navigateur.