Convertir JSON a TOML

Cómo funciona

TOML es el formato de configuración que se lee y edita a mano en el pyproject.toml de Python, el Cargo.toml de Rust y los ajustes de herramientas como Hugo y Netlify. Si sus ajustes están en JSON (generados por un script o devueltos por una API), péguelos en el panel izquierdo; con la dirección "JSON → TOML", el TOML aparece a la derecha. En el ejemplo, el objeto "project" se vuelve la tabla [project], la lista de autores se escribe como [[project.authors]] y los ajustes anidados de "ruff" quedan en la tabla [tool.ruff]. Como TOML no tiene valor null, un campo null no se borra en silencio: la herramienta se detiene y da su ruta (por ejemplo "project.license"). La raíz del JSON tampoco puede ser un array, porque un documento TOML siempre es una tabla; primero ponga el array bajo una clave. Con la dirección "TOML → JSON", la misma página trabaja al revés y señala el TOML con errores por línea y columna.

Esta herramienta también se busca como convertir json a toml, json a toml, json to toml, convertidor json toml, generar toml desde json.

¿Qué es TOML?

TOML (Tom's Obvious, Minimal Language) es un formato de texto pensado para archivos de configuración: las líneas siguen el patrón clave = valor, los encabezados [sección] agrupan ajustes y # abre un comentario. Reconoce textos, enteros, decimales, booleanos, fechas y horas, arrays y tablas, pero no tiene tipo null. La versión 1.0 salió en 2021; Cargo.toml y pyproject.toml son sus usos más conocidos.

¿Qué es Tabla y array de tablas en TOML?

En TOML, un encabezado [tabla] junta las claves que siguen en un objeto, el equivalente de un objeto JSON anidado; [a.b] baja un nivel más. Un encabezado [[tabla]] agrega un objeto nuevo a una lista cada vez que aparece, es decir, un array de objetos JSON. Los objetos cortos también pueden escribirse en una línea como { clave = valor }; esa tabla en línea no se puede ampliar después en otra línea.

¿Qué diferencia hay entre TOML y JSON?

Los dos llevan las mismas estructuras (objetos, arrays, textos, números), pero se hicieron para trabajos distintos. JSON es para intercambio entre máquinas: sintaxis estricta, sin comentarios y con valor null. TOML es para configuraciones que editan personas: admite comentarios, los encabezados [sección] se leen como una lista plana, las fechas y horas tienen tipo propio y no hay null. Por eso los null piden una decisión en la dirección JSON → TOML y las fechas pasan a texto en la dirección TOML → JSON.

Trampas: null, tipos de número y orden de claves

Un null de JSON no tiene equivalente en TOML. Muchos convertidores borran el campo sin avisar, y el ajuste perdido solo se nota cuando el programa se comporta distinto. Esta herramienta indica la ruta del primer null y cuántos más hay; usted decide si quita el campo o le da un texto vacío "" o false.

JSON no separa enteros de decimales, TOML sí: un valor escrito 2.0 en JSON lo lee JavaScript como 2, así que TOML recibe el entero 2. Guarde valores como números de versión en texto ("1.0"). Por las reglas de TOML, las claves simples se escriben antes que las tablas, así que el orden puede cambiar respecto al JSON sin cambiar el significado. Los enteros mayores que 2^53 pueden redondearse al leer el JSON; la herramienta avisa en la nota si ve uno.

Cuándo usar TOML y cuándo JSON

TOML se diseñó para archivos de configuración que las personas editan: admite comentarios con #, y las claves sin comillas y los encabezados [sección] mantienen legible un archivo largo. Cargo, Poetry, uv, Ruff, Black y Hugo leen sus ajustes en TOML. JSON es mejor para intercambiar datos entre programas: no admite comentarios, pero todo lenguaje tiene un lector listo.

Use JSON → TOML cuando un script genera ajustes que van en pyproject.toml o Cargo.toml. Para pasar un archivo TOML a JavaScript, a jq o a una API, cambie la dirección; hay una página aparte dedicada a convertir TOML a JSON y a validarlo.

Preguntas frecuentes

¿Cómo convertir JSON a TOML?

Pegue el objeto JSON en el panel izquierdo de esta página y deje la dirección en "JSON → TOML". Los objetos anidados se vuelven encabezados [tabla] y los arrays de objetos encabezados [[tabla]]. Copie el resultado o descárguelo como .toml.

¿Qué significa el error "TOML no tiene valor null"?

El formato TOML no define un valor vacío (null). Su JSON tiene un campo con valor null y, en lugar de borrarlo en silencio, la herramienta se lo muestra. Quite el campo que indica el mensaje o dele un valor (texto vacío "", 0 o false) y vuelva a intentar.

¿Por qué un JSON con un array en la raíz no pasa a TOML?

Un documento TOML siempre es una tabla hecha de pares clave = valor; una lista sin nombre no puede estar arriba de todo. Ponga el array bajo una clave, por ejemplo {"elementos": [ ... ]}; así cada registro se escribe bajo un encabezado [[elementos]].

¿Mis datos se envían a un servidor?

No. La conversión ocurre por completo en su navegador con una biblioteca TOML de código abierto incluida en la página; ni siquiera un archivo de configuración con contraseñas o claves de acceso sale de esta página. Una vez cargada, la página también funciona sin conexión.