Ambos son formatos de configuración legibles, pero YAML depende de la indentación y tiene coerción implícita, mientras TOML usa tipos y secciones explícitos. Elige según la herramienta y la seguridad al editar.
YAML representa mapas, secuencias y escalares. En el estilo de bloques habitual, la indentación define la jerarquía. Kubernetes y Docker Compose lo usan para configuración. Indenta con espacios, no tabuladores; dos espacios por nivel son una convención, mientras la estructura determina la profundidad.
En key: value, los dos puntos seguidos de espacio separan clave y valor. key:value puede interpretarse como una cadena. Usa comillas para evitar que caracteres especiales, números o booleanos se interpreten de otra manera.
YAML 1.1 interpreta yes, no, on y off como booleanos; YAML 1.2 y cada parser pueden diferir. --- separa documentos, por ejemplo varios recursos Kubernetes. Comprueba el archivo con el formateador YAML y después con el sistema de destino.
Los tabuladores invisibles y los elementos mal alineados pueden causar errores o cambiar la estructura. Activa la visualización de espacios del editor. Las distintas profundidades de indentación no están prohibidas por sí mismas: importa la jerarquía prevista.
Los tipos implícitos dependen de la versión y del esquema. Los ceros iniciales son delicados: 0644 puede interpretarse como octal según YAML 1.1. Pon comillas a identificadores o versiones que deban seguir siendo texto y no presupongas el comportamiento de otro parser.
Los anclajes &name y alias *name reutilizan valores, pero no todos los destinos los admiten igual. Revisa el resultado expandido con YAML a JSON. JSON no conserva comentarios ni sintaxis de alias, por lo que la representación original cambia.
TOML está diseñado para configuración editada por personas. Usa pares clave-valor y secciones como [package], [dependencies] y [dev-dependencies]. Cargo de Rust y pyproject.toml de Python son ejemplos; PEP 518 eligió TOML en 2016 para los requisitos de construcción de Python.
[[table]] inicia un elemento de un array de tablas. Cadenas, enteros, flotantes, booleanos, fechas y horas, arrays y tablas en línea tienen sintaxis definida. port = 8080 es un número y port = "8080" es texto. TOML no incorpora un tipo null.
Los comentarios empiezan con # fuera de cadenas. Comprueba la versión y las funciones del parser, especialmente cadenas multilínea y fechas. El formateador TOML ayuda a revisar el archivo, pero también debe aceptarlo el programa de destino.
Usa YAML cuando lo exija la plataforma, como Kubernetes, Helm o Ansible. Sus comentarios y alias son útiles, pero requieren atención a tipos y estructura. TOML encaja en configuraciones organizadas que las personas editan con frecuencia.
JSON ofrece reglas estrictas y amplio soporte para API o package.json. El estándar no permite comentarios; que una aplicación admita JSON con comentarios no cambia la especificación.
JSON a YAML, JSON a TOML, YAML a JSON y TOML a JSON convierten localmente. Revisa null, fechas, números y arrays anidados. Los comentarios, el formato y toda la información especial de tipos no se preservan automáticamente.
La causa más común es la sangría con tabulaciones frente a espacios. Algunos editores insertan tabulaciones de forma silenciosa. Pasa tu YAML por nuestro Formateador de YAML para normalizar los espacios en blanco antes de hacer commit.
Sí. Un # interpretado como comentario fuera de cadenas hace que se ignore el resto de la línea. Dentro de una cadena, # forma parte del valor y debe conservarse.
TOML 1.0, publicado en 2021, aclaró la sintaxis y detalles de cadenas multilínea, claves y fechas. Comprueba la versión y funciones del parser y valida el archivo en el programa de destino.
Usa nuestro Conversor de YAML a JSON. Pega tu manifiesto y haz clic en Convertir. El resultado es JSON válido que kubectl y la mayoría de los clientes de Kubernetes aceptan.
La comunidad de empaquetado de Python eligió TOML porque admite comentarios (a diferencia de JSON), es inequívoco (a diferencia de los tipos implícitos de YAML) y es fácil de leer para las personas. El PEP 518 (2016) especificó TOML para este propósito.