Datos

Conversor de TOML

Convierte TOML a JSON, YAML, XML, literales de objeto JavaScript o arrays PHP. Las tablas de TOML, que equivalen a objetos o diccionarios, los arrays de tablas ([[x]]), las tablas en línea y las claves con puntos se ordenan como estructuras anidadas comunes, así que archivos de configuración como Cargo.toml, pyproject.toml, la configuración de Hugo y Netlify, wrangler.toml, ruff o Poetry pueden revisarse como JSON o YAML con solo pegarlos. La herramienta también señala los dos cambios que es fácil pasar por alto: las fechas y horas de TOML no tienen un tipo nativo equivalente en JSON y salen como cadenas ISO-8601; los enteros de 64 bits que superan Number.MAX_SAFE_INTEGER se conservan como cadenas exactas para no perder precisión sin darte cuenta. Los errores de análisis incluyen línea, columna y el fragmento cercano. El análisis, la conversión y la copia ocurren en esta pestaña del navegador; nada se sube, se reenvía ni se registra en un servidor.

  • Una sola entrada alimenta cinco destinos —JSON, YAML, XML, literales de objeto JavaScript y arrays PHP— cada uno con sus propias opciones
  • Las tablas se vuelven objetos o diccionarios, y los arrays de tablas ([[servers]]) se vuelven arrays que JSON y YAML entienden
  • Las fechas y horas de TOML se convierten en cadenas ISO-8601 y se marcan, para que veas qué valores pasaron de fecha a cadena
  • Los enteros grandes que superan Number.MAX_SAFE_INTEGER se conservan como cadenas exactas en vez de redondearse, con un aviso que señala cada valor
  • Procesamiento totalmente local —sin subidas, sin telemetría— seguro para configuración de producción, datos de muestra sensibles y borradores de migración
tools/Conversor de TOML
0 caracteres
Esperando entrada
El resultado de la conversión aparece aquí
Acciones

Resumen

Una herramienta pensada para trabajos que empiezan en TOML. Las tablas se tratan como objetos o diccionarios, los arrays de tablas como arrays, y las tablas en línea, las claves con puntos, las fechas y horas nativas y los enteros de 64 bits se resuelven durante el análisis, de modo que la salida queda lista para pipelines de CI, validadores de JSON Schema, generadores de código o scripts que solo aceptan JSON, sin una segunda limpieza manual.

  1. 01

    Cinco formatos de destino listos para usar

    TOML a JSON, YAML, XML, literal de objeto JavaScript y array PHP. JSON y YAML exponen el tamaño de sangría y el orden alfabético de claves; XML permite fijar el nombre de la raíz, el del elemento de lista, la declaración y el formateo; los literales de objeto JS mantienen las claves entre comillas y el escape correcto; los arrays PHP emiten un archivo completo <?php return [...];.

  2. 02

    Las tablas TOML pasan a objetos y los arrays de tablas a arrays

    [section], [nested.section] y [[array.of.tables]] se resuelven en objetos o diccionarios anidados y arrays durante el análisis, de modo que un Cargo.toml o un pyproject.toml puede quedar con la forma JSON que espera un script de compilación, un linter o un validador, sin reorganizar a mano los encabezados TOML.

  3. 03

    Tablas en línea y claves con puntos expandidas

    Las tablas en línea ({ x = 1, y = 2 }) y las claves con puntos (a.b.c = true) se expanden en la misma estructura anidada que produciría una sección completa [a]. Así, dos archivos TOML que solo cambian en el estilo de escritura pueden generar el mismo JSON.

  4. 04

    Manejo explícito de fechas y horas

    Las fechas y horas con desfase, las fechas y horas locales, las fechas locales y las horas locales de TOML se convierten en cadenas ISO-8601, una representación fiable para JSON, YAML y XML. El panel de comprobaciones enumera cada valor para que veas qué fechas pasaron a ser cadenas.

  5. 05

    Precisión de enteros de 64 bits preservada

    TOML admite enteros con signo de 64 bits; los números de JavaScript dejan de ser exactos en 2^53. Los valores fuera de ese rango se conservan como cadenas exactas en lugar de redondearse, y cada uno se marca para que decidas si el siguiente paso debe tratarlos como cadena o como BigInt.

  6. 06

    Todo funciona en el navegador

    El análisis, la conversión, las comprobaciones y la copia ocurren en esta página. Tu TOML nunca sale mediante una petición a un servidor, una CDN o una plataforma de analítica de terceros: seguro para configuración de producción, datos de muestra sensibles y borradores de migración.

Cómo usarla

El flujo es sencillo: pega TOML, elige un formato, revisa el panel de comprobaciones y copia el resultado.

  1. 01

    Pega TOML en el panel de entrada de la izquierda. El análisis ocurre de inmediato y el panel de comprobaciones muestra las tablas TOML como objetos, los arrays de tablas como arrays, los valores de fecha y hora y cualquier aviso sobre enteros grandes.

  2. 02

    Elige un destino abajo: JSON, YAML, XML, objeto JavaScript o array PHP. Cada formato tiene sus propias opciones, como tamaño de sangría, orden de claves o nombre de raíz XML, y la salida se actualiza al momento.

  3. 03

    Revisa el panel de comprobaciones. Las fechas que pasan a cadena y los enteros fuera de rango se marcan pero nunca bloquean la conversión; señalan los puntos donde la representación JSON o YAML difiere del tipo TOML original.

  4. 04

    Cambia a pantalla completa para archivos de configuración largos. Los paneles de entrada y salida ganan espacio y el editor conserva el resaltado de sintaxis, el plegado y los controles de copia.

  5. 05

    Pulsa copiar y pega la salida en tu IDE, gestor de fragmentos, definición de trabajo de CI o cliente de API (Postman, Insomnia, Bruno) para continuar el flujo.

Detalles

Los problemas habituales al trabajar con TOML se resuelven por defecto, así que no hace falta encadenar varias herramientas externas solo para obtener una conversión limpia.

  • El análisis sigue la especificación TOML 1.0, así que las tablas como objetos, los arrays de tablas como arrays, las tablas en línea y las claves con puntos se resuelven exactamente como las leen Cargo, Poetry y Hugo.
  • La salida JSON y YAML conserva el orden de las claves, con un orden alfabético opcional para diffs de git estables, revisión de código y validación de JSON Schema.
  • Las fechas y horas se vuelven cadenas ISO-8601, una representación que los analizadores JSON, los cargadores YAML y el Date de JavaScript pueden manejar directamente.
  • XML acepta nombres personalizados de raíz y de elemento, declaración y formateo para ajustarse con más facilidad a esquemas que ya están en producción.
  • Las salidas de objeto JavaScript y array PHP conservan el anidamiento, el escape y los literales booleanos, así que el resultado se puede usar directamente en cargadores de configuración, datos de prueba o scripts de semillas.
  • El panel de comprobaciones resume la estructura —tablas como objetos, claves y arrays de tablas como arrays— para que un archivo TOML desconocido se vuelva legible en segundos.
  • Los avisos sobre enteros grandes y fechas y horas aparecen en línea, marcando dónde una conversión posterior de vuelta a TOML necesitaría una cadena o un valor tipado para conservar el significado original.
  • Todo se ejecuta localmente en el navegador, sin backend SaaS, así que la herramienta sigue funcionando en un vuelo, en una red solo con VPN o detrás de un proxy corporativo.

Casos de uso

Siempre que la fuente sea TOML, estas tareas cotidianas requieren menos copia manual y menos reescritura línea por línea.

  1. Leer Cargo.toml y manifiestos de espacio de trabajo de Rust

    Convierte un Cargo.toml —dependencias, features, miembros del workspace y destinos [[bin]]— en JSON para que un script de compilación, una auditoría de dependencias o un panel puedan leer el manifiesto de forma programática sin un analizador TOML de por medio.

  2. Inspeccionar pyproject.toml y la configuración de herramientas de Python

    pyproject.toml agrupa los ajustes de Poetry, setuptools, ruff, black y mypy en un solo archivo. Convertirlo a JSON o YAML muestra la forma de objeto resuelta de cada bloque de herramienta y facilita comparar la configuración entre repositorios.

  3. Conectar la configuración de sitios estáticos y edge con otras herramientas

    El config.toml de Hugo, el netlify.toml de Netlify y el wrangler.toml de Cloudflare se escriben en TOML, pero a menudo deben leerlos scripts, pasos de CI o paneles que esperan JSON. Una conversión permite mantener TOML como archivo de referencia y evita que varias copias de la configuración se desvíen.

  4. Migrar configuración entre TOML, YAML y JSON

    ¿Pasas un proyecto de TOML a una configuración basada en YAML o JSON? Mira primero la salida convertida y luego ajústala a mano. El diff estructural atrapa las erratas que introduce reescribir línea por línea.

  5. Alimentar la configuración a validadores de JSON Schema

    Muchos validadores e integraciones de IDE solo aceptan JSON. Convierte TOML a JSON, pásalo por AJV o por la herramienta de esquemas de tu editor y confirma que la configuración cumple su esquema antes de publicarla.

  6. Sincronizar la configuración del backend con los datos de prueba del frontend

    Los backends suelen guardar la configuración en TOML mientras que las pruebas de Jest, Vitest y Storybook del frontend quieren JSON u objetos JS. Convierte y pega: no hace falta un script de transformación a medida.

  7. Auditar campos de fecha y entero antes de una migración

    Las fechas y horas y los enteros de 64 bits de TOML son valores que pueden cambiar de significado cuando una configuración pasa a JSON. El panel de comprobaciones los enumera de entrada para que decidas qué campos deben quedar como cadenas entre comillas en el destino.

  8. Incorporación y revisión de código

    Un archivo TOML denso con [nested.tables] profundas y [[arrays]] repetidos es difícil de leer de un vistazo. Convertirlo a JSON o YAML con sangría convierte esos bloques en una jerarquía visual más fácil de explicar y revisar.

Ver también

Cuando la configuración con la que trabajas empezó siendo YAML —un manifiesto de Kubernetes, un flujo de trabajo de GitHub Actions, un archivo de Docker Compose, una especificación OpenAPI— y necesitas llevarla a JSON, TOML, XML, literales de objeto JavaScript o arrays PHP, recurre al Conversor de YAML , que fusiona el YAML multidocumento en un array y expande las anclas y las claves de fusión antes de convertir. Y cuando la fuente es JSON en vez de TOML —una respuesta de API minificada, la vista JSON de un plan de Terraform, la salida de una herramienta de compilación— y necesitas el sentido contrario de vuelta a archivos YAML, TOML, XML, CSV, objeto JS o array PHP, usa el Conversor de JSON , donde cada destino lleva sus propias opciones: sangría y orden de claves de YAML, nombre de raíz y modo de atributos de XML, delimitador y fila de encabezado de CSV, orden de claves de TOML. Si el propio JSON necesita una limpieza primero —formateo, plegado de nodos profundos, localizar un error de sintaxis o inspeccionar estadísticas de claves antes de decidir a qué destino convertir— pásalo por el Formateador de JSON , que admite plegado jerárquico, resaltado de la línea del error, búsqueda de claves y estadísticas de profundidad con la misma garantía de no subida, así que todo el recorrido desde la configuración en bruto hasta una salida validada y lista para revisar se queda en tu navegador.

Buenas prácticas

TOML es deliberadamente explícito, pero unos pocos hábitos mantienen las conversiones predecibles cuando el formato de destino es menos estricto con los tipos que TOML.

  • Decide de entrada cómo deben representarse las fechas y horas después de la conversión: como cadenas ISO-8601 (lo predeterminado aquí) o como valores tipados que tu cargador vuelve a analizar. Documenta la elección para conservar la intención si más adelante vuelves a TOML.
  • Trata los enteros de 64 bits —ID de Snowflake, marcas de tiempo grandes, claves de base de datos— como cadenas en cualquier JSON que se vaya a releer, ya que los números de JavaScript pierden precisión más allá de 2^53. El panel de comprobaciones marca los valores de riesgo.
  • Recuerda que TOML no tiene null. Al convertir en el sentido inverso más adelante, los null de JSON no tienen equivalente en TOML, así que modela los campos opcionales como claves omitidas en lugar de null explícitos.
  • Tras convertir TOML a JSON, compara el resultado con la versión anterior mediante json-diff para detectar cambios no deseados antes de que lleguen a producción.
  • Prefiere los arrays de tablas ([[x]], que pasan a arrays) frente a tablas en línea muy anidadas para lo que vaya a editar una persona: se convierten en el mismo JSON pero quedan mucho más legibles en la fuente TOML.
  • Mantén el tamaño de sangría y los ajustes de orden de claves coherentes en todo un repositorio para que la salida convertida produzca diffs estables y fáciles de revisar.
  • Cuando una configuración alimente un validador de JSON Schema, conviértela primero a JSON y valida allí; la propia comprobación de sintaxis de TOML no aplica las reglas de campo de tu esquema.
  • Para destinos XML, fija desde el principio un nombre de raíz y de elemento con sentido. Las etiquetas genéricas root/item hacen que la salida sea más difícil de usar en pasos posteriores.

Limitaciones

Saber lo que la herramienta no hace evita que la uses como un IDE de configuración completo, un validador de esquemas o una tubería de migración.

  • Sin validación de esquema de negocio: las reglas del manifiesto de Cargo, las restricciones de campo de pyproject y JSON Schema quedan fuera de alcance; un análisis correcto no es corrección semántica.
  • Los comentarios de TOML no se conservan; las salidas JSON, YAML y XML descartan todo lo que va tras #. Mueve los comentarios esenciales a campos dedicados o a documentación externa si deben conservarse.
  • Las fechas y horas y los enteros de 64 bits se convierten en cadenas para los destinos JSON, YAML y XML: una representación fiel pero no idéntica en tipo. El panel de comprobaciones marca cada uno de esos valores.
  • La herramienta nunca reescribe tu archivo fuente. Las ediciones deben volver al documento original, de modo que el archivo en control de versiones siga siendo la referencia.
  • Los archivos muy grandes pueden ralentizar el navegador, pero el procesamiento se queda local: nada se trunca ni se sube. Valida las opciones con una porción representativa antes de intentar un documento enorme.
  • Sin control de versiones, colaboración, comentarios ni integración con Git: la herramienta está pensada para una conversión e inspección de una sola vez. Combínala con tu flujo de Git para la revisión y la aprobación.
  • Algunas conversiones de TOML a XML chocan con incompatibilidades estructurales, como arrays de tipo mixto o valores que XML no puede representar bien como atributos. La herramienta muestra esos conflictos en vez de producir una salida engañosa.

Preguntas frecuentes

Las preguntas habituales cubren los arrays de tablas como arrays, las fechas y horas, los enteros grandes y si los datos salen del navegador.

¿Cómo se convierten los arrays de tablas ([[x]])?

Cada bloque [[name]] se convierte en un elemento de un array JSON bajo la clave name, en el orden de la fuente. Así, [[servers]] repetido tres veces se convierte en "servers": [ {…}, {…}, {…} ]. Los destinos YAML, objeto JS y array PHP siguen la misma asignación, de modo que nada de la estructura de bloques repetidos se pierde.

¿Por qué mi fecha TOML se convirtió en una cadena en JSON?

JSON, YAML y XML no tienen un tipo de fecha y hora nativo, así que las fechas y horas con desfase, las fechas y horas locales, las fechas locales y las horas locales de TOML se emiten como cadenas ISO-8601. El panel de comprobaciones enumera cada valor de fecha convertido, así que el cambio queda claro. Tu analizador JSON o el Date de JavaScript pueden volver a analizar la cadena cuando necesites una fecha real de nuevo.

¿Qué ocurre con los enteros muy grandes?

TOML admite enteros con signo de 64 bits, pero los números de JavaScript dejan de ser exactos en 2^53 - 1. En lugar de redondear sin avisar un ID de Snowflake o una marca de tiempo grande, la herramienta conserva los enteros fuera de rango como cadenas exactas y marca cada uno en el panel de comprobaciones. Si el siguiente paso necesita un tipo numérico, usa un analizador JSON compatible con BigInt sobre la cadena.

¿Las tablas en línea y las claves con puntos se convierten igual?

Sí. Las tablas en línea { x = 1 } y las claves con puntos a.b = 1 se expanden en los mismos objetos anidados que producen las secciones completas [a], así que dos archivos TOML que solo difieren en el estilo de escritura se convierten en la misma salida JSON, YAML o XML.

¿Puedo convertir JSON o YAML de vuelta a TOML?

Sí, pero desde las otras herramientas: el Conversor de JSON y el Conversor de YAML ofrecen ambos un destino TOML. TOML exige un objeto en el nivel superior y no tiene tipo null, así que un array raíz o un valor null no se pueden representar; esas herramientas informan del conflicto con claridad en lugar de emitir TOML inválido.

¿Por qué la salida conserva el orden de las claves por defecto?

Mantener el orden original de secciones TOML y claves hace que el JSON o el YAML convertidos sean fáciles de comparar con la fuente línea por línea. Cuando en cambio necesites un orden canónico para diffs de git estables o para validación de esquemas, activa el orden alfabético de claves en la fila de opciones.

¿Se suben los datos pegados?

No. El análisis, la conversión, las comprobaciones y la copia ocurren en el navegador. Ninguna petición saca tu TOML de esta página hacia un servidor, una CDN o una plataforma de analítica. Al cerrar la pestaña no queda nada: seguro por igual para configuración de producción, datos de muestra sensibles y borradores de migración.

¿Puedo usarlo sin conexión?

Una vez cargada la página, el navegador ya tiene todos los recursos que necesita para el análisis y la conversión. La herramienta sigue funcionando sin acceso a la red, lo que ayuda en un vuelo, detrás de un proxy corporativo estricto o dentro de una red aislada.

Herramientas relacionadas

Sigue avanzando en el trabajo con datos: convierte YAML o JSON a otros formatos, ordena la estructura JSON o compara dos salidas en paralelo. Las herramientas de abajo encajan en el mismo flujo.