Las herramientas TOML de ToolDeck te permiten formatear, validar y convertir archivos de configuración TOML directamente en el navegador — sin instalación, sin cuenta, sin datos enviados a ningún servidor. El Formateador TOML analiza tu entrada TOML y la vuelve a serializar con indentación coherente, orden de claves normalizado y errores de validación en línea que señalan los problemas de sintaxis. El Convertidor de TOML a JSON transforma documentos TOML en sus equivalentes JSON, conservando los tipos de datos incluidos datetimes, tablas inline y arrays de tablas. Ambas herramientas se ejecutan completamente en el lado del cliente, por lo que tus archivos de configuración — que con frecuencia contienen credenciales de base de datos, endpoints de API y secretos de despliegue — permanecen en tu máquina. Si necesitas la dirección inversa, el Convertidor de JSON a TOML en la categoría JSON se encarga de esa conversión.
¿Qué son las herramientas TOML?
TOML (Tom's Obvious, Minimal Language) es un formato de archivo de configuración construido en torno a una sintaxis explícita e inequívoca. Creado por Tom Preston-Werner, cofundador de GitHub, TOML se publicó por primera vez en 2013 y alcanzó su especificación 1.0 en enero de 2021. El formato se corresponde de forma inequívoca con una tabla hash: cada archivo TOML define un árbol de pares clave-valor organizados en tablas (secciones marcadas con [corchetes]). A diferencia de YAML, TOML no depende de la indentación para la estructura, lo que elimina toda una clase de errores de análisis relacionados con los espacios en blanco. A diferencia de JSON, TOML admite comentarios, tipos nativos de fecha/hora y cadenas multilínea — características que los archivos de configuración necesitan pero que JSON nunca fue diseñado para proporcionar.
Las herramientas TOML automatizan el trabajo mecánico de leer, validar y convertir archivos TOML. Las herramientas de formateo normalizan la indentación y el orden de las claves para que los archivos de configuración sean legibles en todo el equipo, incluso cuando varios colaboradores editan el mismo archivo. Las herramientas de conversión traducen entre TOML y JSON, lo que resulta útil cuando una biblioteca o API espera entrada JSON pero tu fuente de verdad es una configuración TOML. La validación detecta errores de sintaxis — un corchete de cierre que falta, una clave duplicada o un literal de fecha/hora no válido — antes de que provoquen fallos al iniciar la aplicación.
Estas tareas surgen con frecuencia en proyectos Rust (donde Cargo.toml es el manifiesto del paquete), en el empaquetado Python (pyproject.toml reemplazó a setup.py como configuración de compilación estándar en PEP 518 y PEP 621), en sitios estáticos con Hugo (que usa TOML para la configuración del sitio por defecto) y en cualquier configuración de infraestructura que almacene la configuración en archivos TOML. La especificación TOML se mantiene en toml.io, y existen analizadores para todos los principales lenguajes de programación.
¿Por qué usar las herramientas TOML de ToolDeck?
Las herramientas TOML de ToolDeck analizan y procesan todo dentro de la pestaña de tu navegador usando JavaScript. No se transmiten datos de configuración a ningún servidor, no se requiere cuenta y las herramientas funcionan sin conexión tras la carga inicial de la página.
🔒Privado por defecto
Los archivos de configuración suelen contener valores sensibles — URLs de bases de datos, claves de API, destinos de despliegue. ToolDeck procesa TOML completamente en el lado del cliente, por lo que nada sale de tu navegador. Seguro para proyectos propietarios y configuraciones de infraestructura interna.
⚡Respuesta instantánea
Pega TOML y obtén el resultado formateado o el JSON de inmediato. Los errores de sintaxis se reportan con números de línea y descripciones. Sin esperar a que se instale una herramienta de línea de comandos ni a que se complete un paso de compilación.
🔄Conversión de tipos precisa
El convertidor de TOML a JSON conserva los tipos específicos de TOML como datetimes con offset, fechas locales y horas locales como cadenas ISO 8601. Se mantiene la precisión de enteros y flotantes. Los arrays de tablas se mapean correctamente a arrays JSON de objetos.
🌐Sin instalación necesaria
Funciona en cualquier dispositivo con un navegador moderno. Útil cuando revisas una pull request en una máquina sin tu entorno de desarrollo habitual, o cuando necesitas validar rápidamente un archivo TOML de un colega.
Casos de uso de las herramientas TOML
El formateo, la validación y la conversión de TOML surgen en diferentes roles y tipos de proyectos. Los desarrolladores Rust trabajan con Cargo.toml a diario. Los desarrolladores Python configuran compilaciones y herramientas mediante pyproject.toml. Los ingenieros de DevOps gestionan la configuración de aplicaciones en formato TOML. Las tareas siguientes muestran dónde las herramientas TOML en el navegador ahorran tiempo en comparación con escribir un script puntual o instalar una herramienta de línea de comandos.
Limpieza de Cargo.toml
Después de fusionar varias adiciones de dependencias, el Cargo.toml de un proyecto Rust tiene un formateo inconsistente. Pásalo por el
Formateador TOML para normalizar la indentación y el orden de las claves antes de hacer el commit.
pyproject.toml a JSON
Un pipeline de CI necesita los metadatos de compilación en formato JSON, pero la fuente de verdad es pyproject.toml. Usa el
Convertidor de TOML a JSON para generar la representación JSON y verificar el mapeo antes de incluir la conversión en tu pipeline.
Migración de configuración
Al mover una aplicación de configuración basada en JSON a TOML (o viceversa). El
Convertidor de TOML a JSON te permite comparar las dos representaciones lado a lado para confirmar que los tipos de datos, las estructuras anidadas y la semántica de los arrays se conservan.
Depuración de sintaxis
Un archivo de configuración TOML falla al analizarse al iniciar la aplicación con un mensaje de error poco informativo. Pégalo en el
Formateador TOML para obtener números de línea y columna específicos del error de sintaxis, junto con una descripción de lo que esperaba el analizador.
Generación de documentación
Al escribir documentación que incluye ejemplos de configuración en formatos TOML y JSON. Convierte el ejemplo TOML canónico mediante el
Convertidor de TOML a JSON para que ambas versiones se mantengan sincronizadas sin transcripción manual.
Aprender la sintaxis TOML
Los desarrolladores que se inician en TOML pueden experimentar con el formato escribiendo TOML en el
Formateador TOML, viendo los errores de validación en tiempo real y comparando la estructura con la salida formateada. Esto es más rápido que leer la especificación por sí sola.
Referencia de tipos de datos TOML
TOML v1.0 define los siguientes tipos de datos. Cada tipo se corresponde con una representación específica al convertirse a JSON. La tabla siguiente cubre la sintaxis, los ejemplos y el comportamiento de conversión para cada tipo TOML.
| Tipo | Sintaxis | Ejemplo | Mapeo JSON |
|---|
| Cadena | "..." o '...' | name = "TOML" | Cadena JSON. Las cadenas básicas admiten secuencias de escape (\n, \t, \u). Las cadenas literales ('...') tratan las barras invertidas como caracteres literales. |
| Entero | dígitos, 0x, 0o, 0b | port = 8080 | Número JSON. Admite hexadecimal (0xDEAD), octal (0o755), binario (0b1010) y separadores de subrayado (1_000). |
| Flotante | dígitos con . o e | pi = 3.14159 | Número JSON. Admite inf, -inf y nan (mapeado a null o cadena en JSON, ya que JSON no tiene NaN). |
| Booleano | true / false | enabled = true | Booleano JSON. Solo se admiten true y false en minúsculas. |
| Fecha-Hora con offset | RFC 3339 | 2024-01-15T09:30:00Z | Cadena JSON (ISO 8601). Incluye el offset de zona horaria. JSON no tiene un tipo datetime nativo. |
| Fecha-Hora local | fecha T hora | 2024-01-15T09:30:00 | Cadena JSON. Sin información de zona horaria. Útil para horas de reloj de pared. |
| Fecha local | YYYY-MM-DD | 2024-01-15 | Cadena JSON. Fecha sin componente de hora. |
| Hora local | HH:MM:SS | 09:30:00 | Cadena JSON. Hora sin fecha ni zona horaria. |
| Array | [valor, ...] | ports = [8080, 8443] | Array JSON. Los arrays TOML pueden ser heterogéneos en TOML v1.0 pero deben ser homogéneos en v0.5. |
| Tabla | tomlCategoryContent.r10Syntax | [database] | Objeto JSON. Las tablas estándar usan [corchetes]. Las tablas inline usan llaves en una sola línea. |
La especificación TOML v1.0.0 (toml.io) es la versión estable actual. Los arrays de tablas usan [[dobles corchetes]] para definir entradas de tabla repetidas, mapeando a arrays JSON de objetos.
Cómo elegir la herramienta TOML adecuada
ToolDeck tiene tres herramientas que trabajan con archivos TOML. Dos están en la categoría TOML y una está en la categoría JSON para la conversión en sentido inverso. Elige la herramienta que se adapte a tu tarea.
- 1
Si necesitas reindentear un archivo TOML, normalizar el orden de las claves o validar la sintaxis TOML con informes de errores a nivel de línea → Formateador TOML - 2
Si necesitas convertir un archivo de configuración TOML a JSON para usarlo en APIs, scripts o herramientas que esperan entrada JSON → Convertidor de TOML a JSON - 3
Si necesitas convertir un documento JSON a formato TOML para proyectos que usan TOML como estándar de configuración → Convertidor de JSON a TOML
Para el trabajo cotidiano con TOML, el Formateador TOML gestiona el formateo y la validación en un solo paso — pega tu TOML y producirá una salida limpia o te indicará exactamente dónde está el error de sintaxis. Cuando necesitas conectar TOML y JSON, el Convertidor de TOML a JSON preserva todos los tipos de datos TOML incluidos datetimes y tablas anidadas. Para la dirección inversa (JSON a TOML), usa el Convertidor de JSON a TOML en la categoría JSON. Si estás depurando una configuración que falla al analizarse, empieza con el Formateador TOML: sus mensajes de error incluyen números de línea y descripciones de token esperado que son más específicas que las que reporta la mayoría de analizadores TOML a nivel de aplicación.
Preguntas frecuentes
¿Cuál es la diferencia entre TOML y YAML?
TOML usa una sintaxis de corchetes explícita para las tablas y no depende de la indentación para la estructura. YAML usa la indentación para definir la jerarquía, lo que lo hace sensible a los errores de espacios en blanco — un solo espacio mal colocado puede cambiar completamente la estructura analizada. TOML también tiene tipos nativos de fecha/hora y prohíbe las claves duplicadas, mientras que YAML usa silenciosamente el último valor cuando una clave aparece dos veces. TOML es generalmente preferido para la configuración de aplicaciones, mientras que YAML es más común en los manifiestos de Kubernetes y las definiciones de pipelines de CI/CD, donde su soporte multi-documento y los anclajes/alias son útiles.
¿Cuál es la diferencia entre TOML y JSON?
JSON es un formato de intercambio de datos diseñado para la comunicación entre máquinas. TOML es un formato de configuración diseñado para que los humanos lo lean y editen. TOML admite comentarios (líneas que comienzan con #), tipos nativos de fecha/hora, cadenas multilínea y tablas que reducen la profundidad de anidamiento. JSON no admite comentarios, no tiene tipo de fecha y requiere anidamiento explícito con llaves. JSON es la elección correcta para los payloads de API y el almacenamiento de datos; TOML es la elección correcta para los archivos de configuración que los humanos editan a mano.
¿Puede TOML representar todas las estructuras de datos JSON?
TOML puede representar la mayoría de las estructuras JSON, pero hay casos límite. TOML no admite valores null — no existe un equivalente TOML del null de JSON. Las claves TOML deben ser cadenas, lo que coincide con las claves de objetos JSON. Los arrays TOML estaban restringidos a tipos homogéneos en v0.5, pero TOML v1.0 permite arrays de tipos mixtos. Los objetos JSON profundamente anidados pueden volverse verbosos en TOML porque cada nivel de anidamiento requiere un encabezado de tabla separado.
¿Qué proyectos usan TOML para la configuración?
El sistema de compilación Cargo de Rust usa Cargo.toml como manifiesto del paquete. Python adoptó pyproject.toml como archivo estándar de configuración de compilación a través de PEP 518 (2016) y PEP 621 (2020). Hugo, el generador de sitios estáticos, usa TOML para la configuración del sitio por defecto. InfluxDB usa TOML para su configuración de servidor. El sistema de módulos de Go consideró TOML pero eligió su propio formato; sin embargo, muchos proyectos Go todavía usan TOML para la configuración a nivel de aplicación mediante bibliotecas como BurntSushi/toml y pelletier/go-toml.
¿Cómo gestiona TOML los comentarios?
TOML admite comentarios de línea completa y comentarios al final de la línea usando el carácter #. Todo lo que va desde # hasta el final de la línea es ignorado por el analizador. Los comentarios no pueden aparecer dentro de cadenas básicas multilínea ni de cadenas literales multilínea. Al convertir TOML a JSON, los comentarios se descartan porque JSON no tiene sintaxis de comentarios. Esto significa que una conversión de ida y vuelta de TOML a JSON y de vuelta a TOML perderá todos los comentarios del archivo original.
¿Qué son los arrays de tablas en TOML?
Los arrays de tablas usan la sintaxis [[dobles corchetes]] para definir entradas repetidas de la misma estructura de tabla. Por ejemplo, [[servers]] que aparece dos veces crea un array con dos objetos servidor. En JSON, esto se mapea a un array de objetos. Los arrays de tablas se usan comúnmente para listas de dependencias, definiciones de servidores o configuraciones de plugins donde cada entrada tiene el mismo conjunto de claves.
¿Es TOML sensible a los espacios en blanco?
TOML no es sensible a la indentación. La indentación es puramente cosmética y no afecta al análisis. Sin embargo, TOML sí requiere saltos de línea para separar los pares clave-valor — no puedes poner dos pares clave-valor en la misma línea (excepto dentro de las tablas inline). Las tablas inline deben caber en una sola línea y no pueden contener saltos de línea. Este diseño evita los errores basados en indentación que son comunes en los archivos YAML.
¿Qué ocurre con los valores datetime de TOML al convertirlos a JSON?
JSON no tiene un tipo datetime nativo, por lo que los datetimes de TOML se convierten a cadenas ISO 8601. Los datetimes con offset (como 2024-01-15T09:30:00Z) conservan su offset de zona horaria en la representación de cadena. Los datetimes locales, las fechas locales y las horas locales se serializan como cadenas sin información de zona horaria. La conversión no tiene pérdida en el sentido de que el valor original puede analizarse de vuelta desde la cadena, pero el consumidor JSON debe saber que debe tratar estas cadenas como fechas en lugar de texto arbitrario.