Convertir YAML a TOML Gratis – Pasa Configuraciones YAML a TOML

Usa el Convertir YAML 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.

Por qué convertir YAML a TOML

YAML y TOML son los dos formatos de configuración legibles más populares, y cada herramienta prefiere uno distinto. Docker Compose, GitHub Actions y Kubernetes hablan YAML. Rust, el empaquetado de Python y muchas herramientas de sitios estáticos hablan TOML. Cuando pasas un proyecto de un ecosistema a otro, o cuando una herramienta de tu cadena escribe YAML y la siguiente lee TOML, necesitas traducir. Hacerlo a mano es lento y propenso a errores, porque en YAML la sangría tiene significado, y un solo espacio mal puesto puede cambiar la estructura sin que te des cuenta.

Este convertidor hace la traducción por ti, en tu navegador, sin subir nada. YAML se analiza con js-yaml, uno de los analizadores YAML más usados, y TOML se escribe con smol-toml. El resultado es un archivo TOML que puedes colocar directamente en tu proyecto.

Cómo usar el convertidor

Pega YAML en el cuadro de entrada y pulsa Convertir a TOML. El resultado aparece abajo, listo para copiar o descargar. Si el YAML tiene un error de sintaxis, recibes el mensaje de error en lugar de un archivo convertido a medias. Si el YAML describe un solo valor, como un texto o un número suelto, en lugar de un mapa de claves y valores, la herramienta te lo dice claramente, porque los archivos TOML se construyen con pares de clave y valor y un valor suelto no tiene dónde ir.

Empieza con el ejemplo si quieres ver la correspondencia. Muestra una configuración con secciones anidadas para el propietario y el servidor, más una lista de etiquetas. Observa cómo la sangría de YAML se convierte en encabezados de tabla TOML, y cómo la lista YAML se convierte en un arreglo TOML. Una vez que ves ese patrón, puedes predecir el resultado para tus propios archivos.

En qué se diferencian los dos formatos

YAML muestra la anidación con sangría. TOML la muestra con encabezados de tabla entre corchetes. Un bloque YAML como servidor, con anfitrión y puerto sangrados debajo, se convierte en un encabezado [servidor] seguido de las líneas de anfitrión y puerto. Las listas YAML, escritas con guiones, se convierten en arreglos TOML entre corchetes. Los valores simples se trasladan directamente: los textos siguen siendo textos, los números siguen siendo números, y verdadero y falso siguen siendo booleanos.

Algunas funciones de YAML no tienen equivalente en TOML. Las anclas y alias, que permiten reutilizar un bloque de ajustes en varios lugares, se expanden durante el análisis, así que el resultado TOML repite los valores completos. Eso es correcto, aunque más largo. Los textos YAML de varias líneas se convierten en textos TOML normales. Las etiquetas que marcan un valor como un tipo especial casi siempre se pierden, porque en TOML el tipo lo decide el propio valor. Las fechas en YAML pueden convertirse en fechas TOML o en textos según cómo se escribieron, así que revisa los campos de fecha en el resultado.

Qué revisar después de convertir

Primero, revisa las claves que contienen puntos o caracteres especiales. YAML permite muchas formas de clave, y TOML puede escribirlas entre comillas de otra manera. El significado se mantiene, pero el aspecto cambia. Segundo, revisa los valores vacíos. Una clave YAML sin valor se convierte en nulo, y TOML no tiene nulo, así que el convertidor muestra un error en lugar de inventar un valor en silencio. Dale a esas claves un texto vacío o elimínalas antes de convertir. Tercero, revisa las listas muy largas y las estructuras muy anidadas. Se convierten bien, pero el resultado TOML puede ser largo, y vale la pena echarle un vistazo.

Por último, valida el resultado en la herramienta que realmente lo va a leer. Un convertidor garantiza TOML bien formado, pero solo tu aplicación sabe si espera un texto donde tú le diste un número. Ejecuta la aplicación una vez con el archivo convertido antes de borrar el YAML original.

Preguntas frecuentes

¿Puedo convertir un archivo YAML con varios documentos? No. Los archivos con varios documentos separados por tres guiones se rechazan, porque un solo archivo TOML tiene una sola tabla raíz. Divide los documentos y conviértelos uno a uno.

¿Mi YAML se sube a un servidor? No. Todo se hace en tu navegador. Tu configuración nunca sale de tu dispositivo.

¿Por qué desapareció mi ancla? Las anclas son un atajo de YAML, no datos. El analizador las expande a los valores reales, y el resultado TOML contiene esos valores completos.

Pega tu YAML arriba y obtén TOML limpio en segundos, sin reescribir un solo ajuste.

Herramientas relacionadas

• YAML to TOML Converter (English version)
• Formatear y Validar XML
• Convertir XML a YAML