Usa el Convertir JSON a TOML gratuito abajo: tus datos nunca salen de tu navegador, todo el trabajo ocurre en tu dispositivo y no se sube a ningún servidor.
Convertir JSON a TOML, el Formato de Configuración
TOML es el formato de configuración que usan los proyectos Rust, el empaquetado de Python y muchas herramientas de desarrollo. Está diseñado para que lo lean personas: claves y valores en lÃneas simples, secciones entre corchetes y arreglos de tablas entre dobles corchetes. JSON, en cambio, está diseñado para que lo lean máquinas, con llaves y comillas por todas partes. Cuando tienes datos en JSON y los necesitas como archivo de configuración, convertir a mano significa reescribir cada lÃnea y repensar cada objeto anidado. Esta herramienta hace esa traducción por ti.
Pega un objeto JSON y pulsa Convertir. Los valores simples se convierten en lÃneas de clave y valor en la parte superior. Los objetos anidados se convierten en secciones con encabezados entre corchetes. Los arreglos de objetos se convierten en arreglos de tablas, con encabezados de doble corchete, uno por elemento. Los arreglos de valores simples quedan en una sola lÃnea. El resultado es un documento TOML listo para guardar como .toml.
Cómo Funciona la Traducción
Las reglas siguen la forma del propio TOML. Un objeto JSON corresponde a una tabla TOML. Una clave con valor simple se convierte en una lÃnea como title igual a “My App”. Una clave con un objeto se convierte en un encabezado de sección como [database], y una clave con un arreglo de objetos se convierte en una serie de secciones [[servers]], una por elemento.
El orden importa en TOML, y la herramienta lo respeta: los valores simples van primero y después las secciones, porque TOML exige que todas las lÃneas simples aparezcan antes del primer encabezado. Las secciones anidadas usan encabezados con puntos.
Los textos se escriben entre comillas dobles, y dentro de ellos se aplican los escapes habituales. Los números mantienen su forma: los enteros siguen siendo enteros y los decimales siguen siendo decimales. Los booleanos se convierten en true y false en minúscula, como exige TOML. Los arreglos de valores simples se escriben en lÃnea, con elementos separados por comas, que es la forma compacta que TOML permite para listas cortas.
El Problema del Nulo, Resuelto con Honestidad
TOML no tiene valor nulo. JSON sÃ. Cuando un documento JSON contiene un nulo, no existe una traducción fiel a TOML para ese campo, y cualquier herramienta debe tomar una decisión. Esta herramienta omite los campos nulos y los lista en un comentario al principio del resultado, para que veas exactamente qué se dejó fuera y decidas qué hacer al respecto.
Tus opciones para un campo omitido dependen de por qué era nulo. Si es opcional, eliminarlo es correcto. Si necesita un valor, sustitúyelo por un texto vacÃo, un cero o un falso, según el ajuste. Si es un marcador para un valor futuro, añádelo a mano cuando lo conozcas. El comentario garantiza que ninguna decisión ocurra en silencio.
El Motor Detrás de la Herramienta
La conversión usa la biblioteca smol-toml, cargada desde un CDN público, cuando está disponible. Es una implementación TOML pequeña que convierte a texto según la especificación. Si no puede cargar, por ejemplo porque el CDN está bloqueado en tu red, la herramienta recurre a un serializador integrado que produce la misma estructura para documentos normales. El resultado te dice qué motor se ejecutó.
Para la mayorÃa de los documentos, ambos motores coinciden. Si tu documento es inusual, prefiere el resultado de la biblioteca y prueba el resultado analizándolo con un conversor TOML en tus propias herramientas antes de enviarlo como archivo de configuración. Esa comprobación rápida evita sorpresas en el proyecto que recibirá el archivo.
Dónde Sirve Convertir a TOML
Migrar configuración es el uso principal. Una herramienta que exporta ajustes como JSON, o una API que devuelve ajustes como JSON, produce datos que un proyecto basado en TOML no puede leer directamente. Convertirlos aquà te da un archivo de configuración en el formato que el proyecto espera, con secciones y tablas ya en su lugar. Desde ahÃ, pequeños cambios lo adaptan al esquema exacto del proyecto.
Escribir documentación es el segundo uso. Una configuración de ejemplo mostrada como TOML es mucho más fácil de leer que los mismos datos como JSON, porque los encabezados actúan como tÃtulos y los valores quedan en lÃneas limpias. Convierte una exportación de ejemplo y úsala como ejemplo.
Empezar un proyecto nuevo es el tercer uso. Si ya tienes los mismos ajustes en JSON desde otro sistema, convertirlos te da un archivo inicial completo, y solo ajustas los valores que difieren.
Consejos y LÃmites
La entrada de nivel superior debe ser un objeto JSON. Los documentos TOML son tablas, asà que un arreglo o un valor simple en el nivel superior no tiene forma directa en TOML. Si tu JSON es un arreglo, envuélvelo primero en un objeto bajo una clave con significado, y el arreglo se convertirá en una tabla o un arreglo de tablas bajo esa clave.
Las claves con caracteres inusuales se escriben entre comillas en el resultado, ya que TOML solo permite claves simples con letras, dÃgitos, guiones bajos y guiones. Las fechas merecen una nota: JSON no tiene tipo de fecha, asà que una fecha como texto sigue siendo texto en TOML a menos que la reescribas como fecha TOML a mano.
Privacidad
Toda la conversión ocurre en tu navegador: tu JSON nunca sale de tu dispositivo ni se guarda. La herramienta es gratuita y no necesita cuenta.