Leer TOML como JSON
Los archivos TOML son fáciles de editar a mano, pero muchas herramientas, paneles y scripts solo entienden JSON. Convertir un Cargo.toml, pyproject.toml, netlify.toml o una configuración de Hugo a JSON permite inspeccionarlo con herramientas JSON, validarlo o cargarlo sin un analizador de TOML.
Este conversor usa smol-toml, un analizador compatible con TOML 1.0. Las tablas pasan a objetos, los arrays de tablas a arrays de objetos y las tablas en línea a objetos anidados. Un TOML no válido genera un mensaje de error en lugar de un resultado parcial.
TOML frente a JSON: comparación rápida
| Característica | TOML | JSON |
|---|---|---|
| Nombre completo | Tom's Obvious, Minimal Language | JavaScript Object Notation |
| Tipo | Datos de configuración | Datos jerárquicos |
| Año de creación | 2013 | Principios de los 2000 (RFC 4627 en 2006) |
| Creado por | Tom Preston-Werner | Douglas Crockford; hoy ECMA-404 y RFC 8259 |
| Estructura | Pares clave/valor agrupados en [tablas] | Objetos y arrays anidados |
| Comentarios | Sí, con # | No |
| Tipos de datos | Cadena, entero, decimal, booleano, fecha, array, tabla; sin null | Cadena, número, booleano, null, objeto, array |
| Ideal para | Configuración de proyectos como Cargo.toml y pyproject.toml | APIs, aplicaciones web y ajustes de apps |
| Compatibilidad | Rust, Python, Go y la mayoría de lenguajes con librerías | Todos los lenguajes de programación |
| Tipo MIME | application/toml | application/json |
Cómo convertir TOML a JSON
Paso 1: Selecciona el archivo .toml
Suelta tu archivo de configuración en el conversor.
Paso 2: Mantén JSON como destino
JSON está preseleccionado. También están disponibles YAML y XML.
Paso 3: Convierte
El TOML se analiza y se escribe como JSON con sangría.
Paso 4: Descarga
Guarda el archivo .json y úsalo donde quieras.
Correspondencia de tipos
Tablas a objetos
[package] se convierte en un objeto package.
Arrays de tablas a arrays
Las entradas [[bin]] se convierten en un array de objetos.
Fechas a cadenas
Las fechas y horas TOML pasan a cadenas ISO 8601.
Números conservados
Enteros y decimales pasan a números JSON.
Por qué convertir TOML a JSON
Inspeccionar metadatos de proyectos. Lee nombres de paquetes, versiones y dependencias con herramientas JSON.
Scripts de CI. Lee valores de configuración en entornos que solo traen un analizador JSON.
Validación. Comprueba configuraciones con un JSON Schema.
Migrar herramientas. Lleva ajustes a un sistema de configuración basado en JSON.
Precisión y valores especiales
La mayoría del software trata los números JSON como decimales de doble precisión, así que los enteros mayores de unos nueve mil billones (2 elevado a 53) no pueden representarse con exactitud. En lugar de cambiar ese valor sin avisar, el conversor se detiene con un error; escribe los números muy grandes como cadenas entre comillas en el TOML si los necesitas.
El TOML permite inf y nan como valores decimales; el JSON no tiene equivalente y se escriben como null. Los comentarios se eliminan porque el JSON no puede contenerlos.
Cuando la conversión falla
El TOML es estricto. Definir la misma clave dos veces, redefinir una tabla o mezclar una tabla con una clave con puntos del mismo nombre es un error, y el conversor lo indica. El mensaje suele incluir la línea en la que se encontró el problema.
Corregir el TOML en un editor con resaltado de sintaxis es la forma más rápida de resolver estos errores.
- Claves duplicadas: no permitidas.
- Cadenas sin comillas: no permitidas.
- Comas finales en tablas en línea: no permitidas.
Consejos para TOML a JSON
- Pon entre comillas todos los valores de texto en TOML; las palabras sueltas son un error.
- Deja las fechas sin comillas en el TOML si quieres que se traten como fechas.
- Usa JSON a TOML para volver a convertir los datos editados.
- Para listas de dependencias largas, pasa el JSON por jq para consultas rápidas.
Preguntas sobre la conversión de TOML a JSON
¿Qué versión de TOML se admite?
TOML 1.0, mediante el analizador smol-toml.
¿Cómo se convierten las fechas?
En cadenas ISO 8601, como 2026-09-17T10:00:00.000Z, o 2026-09-17 si es solo una fecha.
¿Se conservan los comentarios?
No. El JSON no tiene sintaxis de comentarios.
¿Y los arrays de tablas?
Cada bloque [[tabla]] se convierte en un elemento de un array JSON.
¿Por qué aparece un error?
El TOML es estricto con las claves duplicadas y las comillas. El mensaje de error explica qué ha fallado.
¿Se sube el archivo?
No. Todo se ejecuta en tu navegador.