¿Qué es el Convertidor de JSON a TOML?

El Convertidor de JSON a TOML transforma datos JSON (Notación de Objetos JavaScript) al formato TOML (Lenguaje Mínimo Obvio de Tom). Maneja objetos, arrays, estructuras anidadas y detecta automáticamente valores de fecha para producir una salida TOML limpia y válida.

¿Cuándo lo Necesitas?

Configuración de Proyectos

Convierte archivos de configuración JSON a TOML para herramientas como Cargo (Rust), Hugo o pyproject.toml de Python

Flujos de Trabajo DevOps

Transforma configuraciones JSON a formato TOML para configuraciones de despliegue

Migración de Datos

Mueve datos entre sistemas que utilizan diferentes formatos de configuración

Aprender TOML

Observa cómo las estructuras JSON familiares se traducen a sintaxis TOML

Tus Datos Permanecen Privados

Procesamiento 100% en el Cliente: Toda la conversión ocurre directamente en tu navegador. Tus datos nunca abandonan tu dispositivo y no recopilamos ni almacenamos ningún dato de entrada.

Sin cargas — Tus datos nunca abandonan tu dispositivo
Sin seguimiento — No recopilamos ni almacenamos ningún dato de entrada
Sin procesamiento en servidor — Todo se ejecuta localmente en tu navegador

Cómo Usar

Ingresa tu JSON

Pega o escribe tus datos JSON en el panel izquierdo. También puedes hacer clic en el icono de carga para cargar un archivo JSON desde tu dispositivo.

Conversión Automática

La salida TOML aparece automáticamente en el panel derecho mientras escribes, con validación en tiempo real y formato.

Ajusta las Opciones

Configura los parámetros de conversión como el manejo de valores nulos y el formato de tablas inline para que se adapten a tus necesidades.

Exporta el Resultado

Copia la salida TOML a tu portapapeles o descárgala como archivo .toml para usarla inmediatamente en tu proyecto.

Opciones de Conversión

Manejo de Valores Nulos

Elige cómo manejar valores nulos en tu JSON:

Omitir — Excluye completamente las claves nulas de la salida
Cadena Vacía ("") — Convierte nulo a cadena vacía

Tablas Inline

Formato compacto para objetos pequeños:

Los objetos con ≤3 claves primitivas se muestran como { key = "value" }
Produce una salida más legible y compacta

Carga de Archivos

Haz clic en el icono de carga en la barra de herramientas para cargar un archivo JSON desde tu dispositivo. El contenido del archivo se cargará automáticamente en el editor y se convertirá a formato TOML al instante.

Características Principales

Conversión en Tiempo Real

JSON se convierte a TOML mientras escribes, con debouncing inteligente para optimizar el rendimiento. Los cambios en las opciones de conversión desencadenan una reconversión instantánea, dándote retroalimentación inmediata sobre tu salida.

Mapeo Inteligente de Estructuras

El convertidor mapea inteligentemente estructuras JSON a sus equivalentes TOML con precisión:

Estructura JSON	Salida TOML	Ejemplo
Objetos	Tablas TOML con encabezados `[table]`	`[database]`
Objetos anidados	Notación de ruta con puntos	`[server.config]`
Arrays de objetos	Sintaxis de array de tablas	`[[products]]`
Arrays primitivos	Arrays inline	`["a", "b", "c"]`
Primitivos	Mapeo directo de valores	`port = 8080`

Manejo de Valores Nulos

Limitación de TOML: TOML no soporta nativamente valores nulos. Este convertidor proporciona dos estrategias para manejar esta limitación de manera efectiva.

Estrategia de Omisión

Omitir Claves Nulas

Las claves nulas no aparecen en la salida
Un mensaje de advertencia muestra las claves omitidas
Salida más limpia para campos opcionales

Estrategia de Conversión

Conversión a Cadena Vacía

Nulo se convierte en ""
Preserva todas las claves en la salida
Mantiene la consistencia de la estructura

Tablas Inline

Los objetos pequeños con hasta 3 valores primitivos pueden mostrarse como tablas inline de TOML en lugar de secciones de tabla separadas, produciendo una salida más compacta y legible.

Ejemplo de Tabla Inline

# Without inline tables
[point]
x = 1
y = 2
z = 3

# With inline tables enabled
point = { x = 1, y = 2, z = 3 }

Detección de Fechas

Las cadenas que coinciden con patrones de fecha, hora o fecha-hora RFC 3339 se reconocen automáticamente y se generan como valores de fecha-hora TOML sin comillas, asegurando el manejo correcto del tipo.

Formato de fecha: 2024-01-15
Formato de fecha-hora: 2024-01-15T10:30:00Z
Formato de hora: 10:30:00

Entrecomillado Inteligente de Claves

Las claves JSON que contienen espacios, puntos o caracteres especiales se entrecomillan automáticamente en la salida TOML para validez. Las claves alfanuméricas simples utilizan formato sin comillas para máxima legibilidad.

Ejemplos de Entrecomillado de Claves

# Simple keys (no quotes needed)
name = "John"
age = 30

# Special keys (automatically quoted)
"user.name" = "John"
"first name" = "John"
"api-key" = "secret"

Barra de Estado

La barra de estado en la parte inferior proporciona retroalimentación en tiempo real sobre tu conversión:

Estado de validación — Muestra el estado Válido, Inválido o Listo
Cantidad de claves — Número total de claves en la salida
Tamaño de archivo — Tamaño de salida en bytes para planificación de descarga

Preguntas Frecuentes

¿Por qué no puedo convertir un array JSON como raíz?

TOML requiere que la raíz sea una tabla (pares clave-valor). Un array JSON en el nivel raíz no tiene equivalente en la especificación TOML.

Solución: Envuelve tu array en un objeto primero. Por ejemplo:

Ejemplo de Envolvimiento de Array

// Instead of: [1, 2, 3]
// Use:
{
  "items": [1, 2, 3]
}

¿Cómo se manejan los valores nulos?

TOML no tiene tipo nulo. Puedes elegir entre dos estrategias:

Omitir — Las claves nulas no aparecerán en la salida. Un mensaje de advertencia muestra qué claves fueron omitidas.
Convertir a cadena vacía — Los valores nulos se convierten en "", preservando todas las claves en la salida.

Selecciona la estrategia que mejor se adapte a tu caso de uso en las opciones de conversión.

¿Qué son las tablas inline?

Las tablas inline son una sintaxis TOML compacta para objetos pequeños, mostrados en una sola línea:

Formato de Tabla Inline

point = { x = 1, y = 2 }

Activa la opción Tablas Inline para usar este formato en objetos con hasta 3 valores primitivos. Esto produce una salida más compacta y legible para estructuras simples.

¿Cómo se convierten los arrays de objetos?

Los arrays donde cada elemento es un objeto se convierten en array de tablas TOML usando la sintaxis [[name]]:

Ejemplo de Array de Tablas

[[products]]
name = "Hammer"
price = 9.99

[[products]]
name = "Nail"
price = 0.05

Nota: Los arrays mixtos (que contienen tanto objetos como primitivos) se tratan como arrays inline en su lugar.

¿Se detectan automáticamente las cadenas de fecha-hora?

Sí. Las cadenas que coinciden con patrones RFC 3339 se reconocen automáticamente y se generan como fechas-horas TOML sin comillas:

2024-01-15 — Formato de fecha
2024-01-15T10:30:00Z — Fecha-hora con zona horaria
10:30:00 — Formato de hora

Esto asegura el manejo correcto del tipo y compatibilidad con analizadores TOML.

¿Hay un límite de tamaño?

Como todo el procesamiento ocurre en tu navegador, el límite práctico depende de la memoria disponible y la potencia de procesamiento de tu dispositivo.

Nota de Rendimiento: El convertidor maneja archivos JSON grandes de manera eficiente, pero conjuntos de datos extremadamente grandes (varios MB) pueden causar un rendimiento más lento en dispositivos antiguos.

Para un rendimiento óptimo, recomendamos archivos menores a 5MB. Los archivos más grandes seguirán funcionando pero pueden tardar más en procesarse.