JSON a TOML

Convierte documentos JSON a TOML con indentacion configurable y opciones de formateo.

Convierte documentos JSON a TOML con indentacion configurable y opciones de formateo. Convierte documentos JSON a TOML con indentacion configurable y opciones de formateo.

Salida

Contexto

Por que convertir JSON a TOML

JSON esta en todas partes en la red, pero TOML es el formato que realmente usan los archivos de configuracion modernos (Cargo, pyproject.toml, GitHub Actions, uv y muchos mas). Cuando copias un fragmento JSON de una API a un archivo de configuracion, normalmente tienes que traducir la sintaxis a mano: las llaves se vuelven secciones, los corchetes matrices, las comas saltos de linea y las claves entre comillas pasan a ser claves desnudas.

Un conversor automatiza esa traduccion: pegas la respuesta de la API, copias la salida TOML y listo.

Caracteristicas que conviene conocer

La mayoria de los conversores preservan el orden de los objetos JSON por defecto. TOML permite reordenar secciones, asi que una opcion de "ordenar claves" ayuda cuando quieres un diff estable entre ejecuciones. El control de indentacion te permite ajustarte a la guia de estilo del proyecto (dos o cuatro espacios).

Para matrices de tablas en TOML, el conversor emite la forma en linea key = [ ... ] cuando la matriz JSON contiene un unico objeto uniforme, y la forma con cabecera [[section]] para listas que mezclan tipos o repiten el mismo esquema. Este es el unico caso donde la conversion no es completamente mecanica.

Consejos de flujo de trabajo

Antes de hacer commit del TOML, verifica que las claves que usaste en JSON sean claves desnudas validas en TOML (sin espacios, sin digitos iniciales, sin guiones al inicio). El conversor conserva los nombres literalmente; no los renombra. Tras la conversion, pega en tu editor y ejecuta el linter del proyecto para captar cualquier problema de estilo que el conversor no conoce.

Desarrollado internamente. El JSON se lee con JSON.parse nativo; la salida la genera la biblioteca smol-toml (BSD-3) empaquetada en public/assets. Nada se envia a un servidor.

Preguntas frecuentes

El conversor soporta objetos anidados?
Si. Los objetos JSON anidados se convierten en tablas TOML anidadas. El conversor preserva la profundidad y un anidamiento muy profundo se expande en cabeceras [[section.sub]] segun corresponda.
Que pasa con las matrices de primitivos?
Las matrices de primitivos (numeros, cadenas, booleanos) se convierten en matrices en linea TOML. Las matrices de tipos mixtos son rechazadas por el parser subyacente porque TOML exige matrices homogeneas.
Se conservan los valores null de JSON?
TOML no tiene literal null. El conversor descarta los null y emite un aviso; si necesitas registrar ausencia, usa cadena vacia o un valor centinela antes de convertir.
Por que faltan los comentarios del JSON original?
JSON no admite comentarios. Si necesitas comentarios en el TOML, agregalos a mano despues de la conversion.
El conversor cambia el orden de las claves?
No. Por defecto las claves se emiten en el orden del JSON. Activa la opcion de ordenar si quieres una disposicion alfabetica estable para diffs.
Mi JSON se envia a algun sitio?
No. La conversion ocurre enteramente en tu navegador usando JSON.parse nativo y la biblioteca smol-toml empaquetada.