Conversor de TOML a JSON

Bienvenido al Conversor de TOML a JSON, una herramienta en línea gratuita que convierte cualquier configuración TOML en un JSON limpio y válido con un solo clic. Ya sea que estés migrando un Cargo.toml a un flujo basado en JSON, depurando visualmente configuraciones profundamente anidadas o integrando un archivo TOML en un servicio que solo acepta JSON, este conversor maneja correctamente cada constructor de TOML: tablas, subtablas, arreglos de tablas, tablas en línea, claves punteadas, cadenas multilínea, enteros hexadecimales/octales/binarios, fechas y números de punto flotante especiales. Elige el estilo de salida que mejor se adapte a tu trabajo (estético de 2 espacios, estético de 4 espacios, compacto o ordenado por clave) e inspecciona el resultado a través de un árbol de estructura, un panel de estadísticas y un diagrama de transformación.

¿Qué es TOML y por qué convertirlo a JSON?

TOML (Tom's Obvious Minimal Language) es un formato de configuración diseñado para ser inequívoco y fácil de leer para los humanos. Es el motor de los metadatos de paquetes para Cargo (Rust), Poetry (Python) y muchas otras herramientas de desarrollo. JSON, por otro lado, es el formato universal de intercambio de datos en la web. Muchos sistemas (APIs REST, bases de datos de documentos, el localStorage del navegador y aplicaciones JavaScript) solo hablan JSON. Convertir TOML a JSON te permite unir estos dos mundos sin tener que reescribir tu configuración.

Razones comunes para convertir TOML a JSON

• Enviar TOML a una API que solo acepta JSON: por ejemplo, un servicio de despliegue o una plataforma de banderas de características (feature-flags).
• Inspeccionar visualmente configuraciones anidadas: la estructura de corchetes y llaves de JSON hace que la jerarquía sea obvia a simple vista.
• Generar paquetes de configuración para el front-end: mantén tu formato de autoría en TOML, pero envía JSON al navegador.
• Trabajar con linters y JSON Schema: valida la estructura de TOML pasándola a través de un validador de JSON Schema.
• Comparar configuraciones: utiliza la comparación (diff) de JSON con claves ordenadas entre entornos para detectar desviaciones.
• Migrar configuraciones heredadas: porta gradualmente un archivo TOML a un servicio de configuración basado en JSON.

Características principales de este conversor

• Cobertura completa de TOML 1.0: cadenas básicas y literales (simples y multilínea), enteros en decimal/hexadecimal/octal/binario con separadores de guion bajo, números de punto flotante con notación científica, inf, -inf, nan, booleanos, fechas y horas.
• Estructuras anidadas: tablas, subtablas ([a.b.c]), arreglos de tablas ([[a]]), tablas en línea ({ a = 1, b = 2 }) y claves punteadas.
• Cuatro estilos de salida: estético de 2 espacios, estético de 4 espacios, compacto (minificado) y claves ordenadas para una salida fácil de comparar.
• Árbol de estructura visual: observa cómo los constructores de TOML se convierten en objetos y arreglos JSON, con etiquetas de tipo (tabla, AoT, arreglo, cadena, número, booleano).
• Panel de estadísticas: recuento de tablas, claves, arreglos, arreglos de tablas, profundidad, además de recuentos de caracteres de entrada y salida.
• Mensajes de error con línea identificada: cada error de análisis incluye el número de línea exacto para que puedas corregirlo al instante.
• Biblioteca de muestras de un solo clic: carga ejemplos estilo Cargo.toml, pyproject, configuración de aplicaciones, números o cadenas multilínea.
• Copiar y descargar: copia el JSON al portapapeles o descárgalo como un archivo .json.
• Adaptado a móviles: funciona cómodamente en teléfonos, tabletas y computadoras de escritorio.
• Privacidad garantizada: el TOML se analiza en el servidor y el resultado se devuelve en la misma respuesta; no se almacena nada.

Cómo se mapea TOML a JSON

La mayoría de los constructores de TOML tienen un equivalente en JSON limpio y sin pérdida de datos. Aquí tienes el mapeo que aplica el conversor:

Ejemplos

title = "App"
[server]
host = "localhost"
port = 8080

{
  "title": "App",
  "server": {
    "host": "localhost",
    "port": 8080
  }
}

[[user]]
name = "Alice"
admin = true

[[user]]
name = "Bob"
admin = false

{
  "user": [
    { "name": "Alice", "admin": true },
    { "name": "Bob",   "admin": false }
  ]
}

db.host = "10.0.0.1"
db.port = 5432
db.options = { ssl = true, pool = 20 }

{
  "db": {
    "host": "10.0.0.1",
    "port": 5432,
    "options": { "ssl": true, "pool": 20 }
  }
}

Cómo usar el Conversor de TOML a JSON

1. Pega tu TOML en el cuadro de entrada, o haz clic en una muestra rápida para cargar una configuración típica.
2. Elige un estilo de salida: estético de 2 espacios (predeterminado), estético de 4 espacios, compacto o claves ordenadas.
3. Haz clic en Convertir a JSON. La herramienta analiza el TOML y genera la salida JSON con estadísticas y un árbol de estructura.
4. Inspecciona el resultado: revisa el panel de estadísticas para un resumen rápido, expande el árbol de estructura para ver la jerarquía y lee el diagrama de conversión para entender el mapeo.
5. Copia o descarga el JSON. El botón Copiar lo pone en tu portapapeles; Descargar lo guarda como convertido.json.

Funciones de TOML compatibles

Cadenas

• Cadenas básicas: usan comillas dobles y admiten secuencias de escape: \n, \t, \r, \", \\, \uXXXX, \UXXXXXXXX.
• Cadenas literales: usan comillas simples y contienen caracteres brutos sin escapes.
• Cadenas básicas multilínea: usan triples comillas dobles (""") y admiten barra invertida al final de línea para eliminar espacios en blanco.
• Cadenas literales multilínea: usan triples comillas simples (''') y preservan todo textualmente.

Números

• Enteros decimales con separadores de guion bajo opcionales: 1_000_000.
• Enteros hexadecimales/octales/binarios: 0xDEADBEEF, 0o755, 0b1010.
• Flotantes con signo, decimal y exponente opcionales: 3.14, -2e-3, 6.022e23.
• Flotantes especiales: inf, -inf, nan (convertidos a null en JSON).

Tablas y Arreglos

• Tablas: [nombre] abre una nueva tabla.
• Subtablas: [a.b.c] crea tablas anidadas.
• Arreglos de tablas: [[nombre]] añade una nueva tabla a un arreglo.
• Tablas en línea: { a = 1, b = 2 }.
• Arreglos: [1, 2, 3] pueden ocupar varias líneas y contener tipos de valores mezclados.

Elegir el estilo de salida adecuado

• Estético de 2 espacios: el predeterminado. Compacto pero legible; ideal para la mayoría de los usos, incluidos los archivos de configuración en git.
• Estético de 4 espacios: coincide con la sangría estilo PEP-8; preferido por algunos equipos de Python y Java.
• Compacto (minificado): una sola línea, sin espacios en blanco adicionales; el tamaño de carga más pequeño para la transmisión por red.
• Claves ordenadas: salida estética con las claves ordenadas alfabéticamente. Excelente para comparaciones (diffs) porque las configuraciones idénticas siempre producen la misma salida byte por byte, independientemente del orden de las claves.

Preguntas frecuentes

¿Qué es TOML y por qué convertirlo a JSON?

TOML es un formato de configuración diseñado para ser obvio y mínimo. Convertirlo a JSON permite introducir configuraciones en sistemas que solo aceptan JSON, depurar visualmente la estructura anidada, compartir con APIs web e integrar con código JavaScript que espera JSON.

¿Este conversor maneja arreglos de tablas y tablas en línea?

Sí. El conversor admite totalmente la sintaxis [[arreglo.de.tablas]] (traducida a arreglos JSON de objetos), tablas en línea como { a = 1, b = 2 } (traducidas a objetos JSON), subtablas anidadas, claves punteadas y profundidad de anidamiento arbitraria.

¿Qué estilos de salida son compatibles?

Cuatro estilos: Estético de 2 espacios (predeterminado), Estético de 4 espacios (sangría PEP-8), Compacto (minificado) y Claves Ordenadas (estético y alfabético).

¿Cómo se convierten las fechas de TOML a JSON?

JSON no tiene un tipo nativo para fechas, por lo que las fechas de TOML (RFC 3339) se preservan como cadenas. Los formatos locales también se mantienen textualmente para ser analizados por bibliotecas externas.

¿Qué sucede con los valores inf y nan de TOML?

Dado que el JSON estándar no permite Infinity ni NaN, estos valores se convierten a null para asegurar que la salida cumpla con RFC 8259.

¿De dónde vienen los errores de análisis y cómo los soluciono?

El conversor indica la línea exacta del error. Los problemas comunes incluyen comillas sin cerrar, el uso de pestañas (tabs) donde no se permiten o la redefinición de tablas.

¿Hay un límite de tamaño?

La herramienta puede manejar archivos TOML de varios megabytes sin problemas. Para archivos extremadamente grandes, el rendimiento depende más del renderizado del navegador que del análisis en sí.

¿Se envían o almacenan mis datos TOML?

Tu entrada se analiza en el servidor para generar la salida JSON y luego se descarta. No registramos, almacenamos ni transmitimos tu configuración a ningún otro lugar.

¿Puedo convertir JSON de nuevo a TOML?

Esta herramienta es de una sola vía (TOML → JSON). Para el sentido inverso, utiliza un conversor de JSON a TOML o bibliotecas de programación como tomli_w (Python), @iarna/toml (JavaScript) o el crate toml (Rust).

Consejos para conversiones limpias

• Usa la salida de claves ordenadas para diffs: tu JSON bajo control de versiones será estable para todos los miembros del equipo.
• Prefiere las cadenas multilínea (""" o ''') para párrafos de texto en lugar de concatenar con escapes \n.
• Agrupa claves relacionadas con tablas: son más legibles que las claves punteadas largas.
• Cuidado con la redefinición accidental de tablas: TOML no permite definir la misma tabla dos veces; el conversor detecta esto con un error claro.
• Mantén las fechas y horas en RFC 3339: los formatos locales también funcionan, pero el RFC 3339 se integra mejor con los consumidores de JSON.

Recursos adicionales

• Especificación oficial de TOML
• TOML en Wikipedia
• JSON.org — introducción a JSON
• RFC 8259 — El formato de intercambio de datos JavaScript Object Notation (JSON)