Cómo convertir TOML a JSON paso a paso

Antes de empezar

Este conversor transforma texto de configuración TOML en una representación JSON. Es útil cuando necesitas revisar la misma información con la estructura habitual de JSON o preparar una configuración para una herramienta que trabaje con ese formato.

Puedes introducir valores escalares, como cadenas, números y valores booleanos, además de tablas anidadas. También puedes decidir cuántos espacios usa la representación JSON y si las claves deben ordenarse. Si el contenido está vacío o solo contiene espacios, la conversión genera un objeto JSON vacío.

Cómo convertir TOML a JSON

1. Escribe o pega el contenido TOML en el campo de entrada. Por ejemplo, puedes incluir una tabla principal con claves y otra tabla anidada.
2. Revisa el contenido antes de convertirlo. Las cadenas, los números, los valores booleanos y las tablas anidadas deben seguir la sintaxis de TOML. Las fechas, horas y fechas con hora también son compatibles, pero aparecerán serializadas como cadenas con formato ISO.
3. Ajusta la indentación numérica de la salida si necesitas una representación más compacta o más espaciada. Si no cambias esta opción, se utiliza una indentación de 2.
4. Activa la ordenación de claves solo si quieres que las claves de la representación JSON se organicen. Esta opción está desactivada inicialmente.
5. Ejecuta la conversión y revisa la representación JSON generada. Si el resultado no se produce, comprueba primero la sintaxis TOML y vuelve a intentarlo.

No necesitas añadir contenido para comprobar el comportamiento con una entrada vacía: un campo sin texto o con espacios produce un objeto JSON vacío.

Cómo interpretar el resultado

La salida conserva la información estructural del TOML en una representación JSON: las tablas anidadas aparecen como objetos dentro de otros objetos y los valores compatibles mantienen su tipo correspondiente. La indentación cambia la presentación, no el contenido representado. La ordenación de claves modifica el orden mostrado cuando se activa.

Una conversión fallida no debe interpretarse como una reparación automática del texto. El TOML mal formado provoca una conversión no satisfactoria y no genera una representación convertida. Además, puede producirse un fallo si la serialización JSON no puede completarse para algún valor. En esos casos, revisa el contenido y sus valores antes de usar la salida.

Ejemplo práctico

Necesitas pasar una configuración TOML sencilla con una tabla anidada a una representación JSON para revisarla.

Pega este contenido: nombre = "app" y [servidor] seguido de puerto = 8080. Mantén la indentación predeterminada y ejecuta la conversión.

La salida tiene un objeto JSON con una clave de configuración y un objeto anidado para la tabla secundaria; la indentación se muestra con 2 espacios si se mantiene el valor predeterminado.

Limitaciones

• El TOML mal formado produce una conversión fallida, y la serialización JSON también tiene un límite: puede devolver un fallo si no consigue serializar un valor.

Errores frecuentes

• Un error habitual es pegar TOML mal formado, por ejemplo, con una estructura de tabla o un valor que no respeta la sintaxis. Corrige el texto de entrada y vuelve a ejecutar la conversión; el conversor no transforma ese contenido en JSON cuando el TOML es inválido.

Preguntas frecuentes

¿Qué ocurre si dejo vacía la entrada TOML?

El texto vacío o compuesto solo por espacios se procesa correctamente y produce una representación de objeto JSON vacío.

¿Puedo convertir tablas anidadas y fechas TOML?

Sí, siempre que respeten la sintaxis TOML. Las tablas anidadas se representan como estructuras JSON anidadas, y las fechas, horas y fechas con hora se serializan como cadenas con formato ISO.

¿Por qué puede fallar la conversión?

La conversión no genera una representación JSON cuando el TOML está mal formado. También puede fallar si no se puede completar la serialización JSON de un valor.