Format Atlas

Comparar

YAML vs TOML

YAML y TOML son formatos de texto usados para configuración editada por personas. YAML admite jerarquías flexibles; TOML prioriza ajustes explícitos y legibles mediante claves y tablas. Elige según la herramienta y la estructura.

¿Qué formato deberías elegir?

Usa YAML si la herramienta lo exige o la configuración necesita anidamiento complejo. Considera TOML para ajustes sencillos con tablas y tipos claros.

Adecuado para YAML

Archivos de configuración y datos estructurados

  • Configuración mantenida por personas

Adecuado para TOML

Configuración de aplicaciones y herramientas

  • Ajustes legibles con valores estructurados

Información básica

CampoYAMLTOML
Extensión.yaml, .yml.toml
Tipo MIMEapplication/yamlapplication/toml
Usos habitualesArchivos de configuración y datos estructuradosConfiguración de aplicaciones y herramientas
Cómo abrirÁbralo en un editor de texto o herramienta YAML y conserve la sangría con espacios.Ábralo en un editor y consulte la documentación de la aplicación sobre TOML compatible.
Exportar o convertirSi el destinatario necesita JSON, conviértalo y compruebe tipos y codificación.Al convertir desde JSON o YAML, compruebe anidación, listas, comillas, fechas y tipos tras analizar.

Elegir según el uso

Configuración mantenida por personas

Archivos de configuración y datos estructurados

YAML

Ajustes legibles con valores estructurados

Configuración de aplicaciones y herramientas

TOML

Punto clave 1

YAML permite estructuras jerárquicas ricas, pero hay que cuidar la indentación y los tipos implícitos.

Más sobre las diferencias

Punto clave 2

TOML usa una sintaxis explícita de claves, valores y tablas pensada para facilitar la lectura de configuraciones.

Más sobre las diferencias

Más sobre las diferencias

Sigue el formato y la versión admitidos por la herramienta de destino. Valida con el analizador y esquema reales, sobre todo fechas, números, anidación y sintaxis sensible a espacios.

  • YAML es común en herramientas de infraestructura y automatización que lo requieren.
  • TOML puede hacer más claras las opciones de una aplicación, pero no lo aceptan todas las herramientas basadas en YAML.
  • Los dos formatos pueden interpretarse mal si difieren los ajustes del analizador o las reglas de tipos.

Preguntas frecuentes

¿TOML es más sencillo que YAML?

Puede serlo para muchas configuraciones simples, pero mandan los requisitos de la herramienta y la estructura. Usa el formato que la aplicación admita con fiabilidad.

Más información

Usos y comprobaciones relacionados

Elegir un formato de configuración

Referencias y especificaciones