Por qué TOML para la configuración
El TOML se diseñó como un formato de configuración obvio y mínimo: pares clave = valor, [secciones] para agrupar y comentarios con #. Cargo de Rust, pyproject.toml de Python, Hugo, Netlify y muchas otras herramientas lo usan.
Este conversor traduce los objetos JSON a tablas TOML y los arrays de objetos a arrays de tablas, conserva el orden de tus claves y escribe los valores con las comillas correctas. Como el TOML no tiene null, los valores null se omiten en lugar de generar un archivo no válido.
JSON frente a TOML: comparación rápida
| Característica | JSON | TOML |
|---|---|---|
| Nombre completo | JavaScript Object Notation | Tom's Obvious, Minimal Language |
| Tipo | Datos jerárquicos | Datos de configuración |
| Año de creación | Principios de los 2000 (RFC 4627 en 2006) | 2013 |
| Creado por | Douglas Crockford; hoy ECMA-404 y RFC 8259 | Tom Preston-Werner |
| Estructura | Objetos y arrays anidados | Pares clave/valor agrupados en [tablas] |
| Comentarios | No | Sí, con # |
| Tipos de datos | Cadena, número, booleano, null, objeto, array | Cadena, entero, decimal, booleano, fecha, array, tabla; sin null |
| Ideal para | APIs, aplicaciones web y ajustes de apps | Configuración de proyectos como Cargo.toml y pyproject.toml |
| Compatibilidad | Todos los lenguajes de programación | Rust, Python, Go y la mayoría de lenguajes con librerías |
| Tipo MIME | application/json | application/toml |
Cómo convertir JSON a TOML
Paso 1: Selecciona un archivo JSON
Suelta el archivo .json de configuración o de datos en el conversor.
Paso 2: TOML está preseleccionado
Deja TOML como salida.
Paso 3: Convierte
Los objetos pasan a tablas, los arrays a arrays TOML y se eliminan los null.
Paso 4: Descarga el archivo .toml
Añade comentarios y colócalo en tu proyecto.
Cómo se traduce el JSON a TOML
Tablas
Los objetos anidados pasan a tablas [seccion] y [seccion.sub].
Arrays de tablas
Los arrays de objetos se convierten en bloques [[seccion]].
Tratamiento de null
Los valores null se eliminan porque el TOML no puede representarlos.
Arrays de nivel superior
Un array JSON se envuelve bajo una clave items, ya que el TOML necesita una tabla en la raíz.
Dónde es práctico JSON a TOML
Proyectos en Rust. Redacta secciones de Cargo.toml a partir de datos JSON.
Empaquetado en Python. Lleva ajustes a pyproject.toml.
Generadores de sitios estáticos. Hugo y Zola leen configuración en TOML.
Ajustes legibles. Ofrece a tus usuarios un archivo de configuración con comentarios.
Lo que el TOML no puede expresar
El TOML no tiene valor null, así que las claves con null se eliminan. Los arrays de TOML 1.0 pueden mezclar tipos, pero algunos analizadores antiguos rechazan los arrays mixtos, así que mantenlos homogéneos si tu herramienta es estricta.
El JSON no tiene tipo fecha, así que las fechas de tu JSON se escriben como cadenas entre comillas. Si tu herramienta espera fechas TOML reales, quita las comillas después de convertir.
- "timeout": null se elimina.
- "started": "2026-09-17" sigue siendo una cadena entre comillas.
- [1, 2, 3] sigue siendo un array en línea.
Leer el resultado
Los valores simples de nivel superior aparecen primero, seguidos de las tablas. Los objetos anidados se escriben con cabeceras de tabla con puntos como [server.tls], que es TOML estándar.
Las claves con espacios, puntos u otros caracteres especiales se entrecomillan para que el archivo se analice correctamente.
Consejos para JSON a TOML
- Sustituye los null por valores por defecto antes de convertir si las claves tienen que existir.
- Comprueba el resultado con la herramienta que lo va a leer; cada una espera sus propias claves.
- Añade comentarios encima de las tablas para explicar los ajustes.
- Usa TOML a JSON para verificar la ida y vuelta.
Preguntas sobre la conversión de JSON a TOML
¿Qué pasa con los valores null?
Se eliminan, porque el TOML no tiene tipo null.
¿La raíz del JSON puede ser un array?
Sí. Se envuelve bajo una clave items, porque un documento TOML debe ser una tabla.
¿Cómo se escriben los arrays de objetos?
Como arrays de tablas con dobles corchetes, como [[items]].
¿Se conserva el orden de las claves?
Sí, dentro de las reglas del TOML, donde los valores simples van antes que las tablas.
¿Qué versión de TOML se genera?
TOML 1.0, escrito con la biblioteca smol-toml.
¿Se sube mi archivo?
No. La conversión se hace en tu navegador.