¿Qué es el formato de archivo YAML?
.yaml es un formato de archivo de texto utilizado para intercambiar datos entre diversas aplicaciones. YAML - acrónimo de *YAML Ain't Markup Language* - es un estándar para organizar información en un formato legible por humanos e independiente de la plataforma, utilizando pares key: value basados en sangría y codificados en UTF-8. El análisis de archivos .yaml requiere la instalación de una biblioteca YAML; las bibliotecas populares incluyen PyYAML (Python), js-yaml (JavaScript) y SnakeYAML (Java). Los archivos .yaml a veces se guardan con la extensión .yml, que es funcionalmente idéntica. Más allá del intercambio de datos, los archivos .yaml se utilizan habitualmente para serializar datos y para escribir archivos de configuración en herramientas como Docker Compose, Kubernetes y GitHub Actions.
Serialización
La serialización es un término utilizado en informática. Es el proceso de traducir datos u objetos a un formato que pueda ser almacenado, transmitido y reconstruido posteriormente. Por ejemplo, dos instituciones que intercambian datos en un formato estandarizado utilizando diferentes aplicaciones deben serializar esos datos antes de enviarlos. Los datos serializados también pueden almacenarse en un archivo - .yaml, .xml, .json, .toml, etc. - y luego enviarse a los destinatarios.
Un documento .yaml puede comenzar opcionalmente con el marcador de inicio de documento --- y terminar con ...; esto también permite múltiples documentos dentro de un solo archivo. Desde YAML 1.2 (2009, revisado en 2021), cada archivo JSON válido es también un YAML válido.
Seguridad y protección
RIESGO: MEDIUMUn archivo YAML es texto plano y no se ejecuta por sí solo, por lo que leerlo es seguro. Dos riesgos reales: (1) los YAML de configuración (flujos de CI, Compose, K8s, Ansible) frecuentemente contienen secretos - tokens, contraseñas, claves - así que no los pegue en validadores en línea no confiables ni los publique en repositorios. (2) Peligro programático: cargar YAML no confiable con un analizador inseguro (por ejemplo, yaml.load de PyYAML en lugar de yaml.safe_load) puede ejecutar objetos o código arbitrario - use siempre el cargador seguro para archivos en los que no confíe. Riesgo de edición: un tabulador o un espacio mal alineado cambia silenciosamente el significado, así que valide después de editar.
Detalles del formato
en pocas palabrasNOMBRE COMPLETOYAML Ain't Markup Language file
DESARROLLADORClark Evans, Ingy döt Net, Oren Ben-Kiki (YAML spec)desde 2001 (YAML 1.0); YAML 1.1 (2005); current YAML 1.2 (2009, revised 2021)
CATEGORÍAArchivos de desarrollo
TIPO MIMEapplication/yaml
TIPOTexto de serialización de datos legible por humanos (basado en sangría, UTF-8)
ESTÁNDARAbierto · libre de regalías
Programas que abren archivos YAML
Windows4 apps
Sublime Text
Freemium Abra el .yaml para una edición rápida con resaltado YAML; configure «translate tabs to spaces» para que la sangría siga siendo válida. 
Windows Notepad
Integrado Abre YAML como texto para un vistazo rápido, pero no muestra espacios en blanco ni tabuladores, por lo que es arriesgado para editar YAML sensible a la sangría. 
Notepad
Código abierto Abrir con resaltado de sintaxis YAML; active Ver > Mostrar símbolo > Mostrar espacios en blanco para mantener la sangría correcta. 
Visual Studio Code
Gratis Abra el archivo; la extensión YAML integrada o la de Red Hat ofrece resaltado, guías de sangría, validación de esquemas y avisos de error. La mejor opción para YAML. 
macOS3 apps
TextEdit
Integrado Primero Formato > Convertir a texto plano y desactive las comillas inteligentes; pero no mostrará los espacios en blanco, por lo que es preferible un editor de código para editar.
Visual Studio Code
Gratis Abra el archivo; la extensión YAML integrada o la de Red Hat ofrece resaltado, guías de sangría, validación de esquemas y avisos de error. La mejor opción para YAML. 
Sublime Text / BBEdit
Freemium Abra el .yaml en un editor de código para obtener un resaltado YAML adecuado y una sangría basada en espacios. 
Linux3 apps
Visual Studio Code
Gratis Abra el archivo; la extensión YAML integrada o la de Red Hat ofrece resaltado, guías de sangría, validación de esquemas y avisos de error. La mejor opción para YAML.
GNOME Text Editor / gedit
Código abierto Abrir con resaltado YAML; configúrelo para insertar espacios (no tabuladores) antes de editar.
vim / nano
Código abierto Edite en la terminal; en Vim use «:set expandtab» para que la sangría use espacios. Estándar para archivos de configuración de servidores.
Web1 app
YAML Lint / online YAML validators
Gratis Pegue el archivo para validar la sintaxis y darle un formato legible en el navegador. No pegue secretos - los archivos YAML de configuración a menudo contienen credenciales. Detalles técnicos
especificación profunda| Extensión de archivo | .yaml (también .yml) |
| Tipo MIME | application/yaml |
| Codificación | Texto plano UTF-8; sin encabezado binario ni magic bytes |
| Estructura | Pares clave: valor basados en sangría; la sangría usa solo espacios - los tabuladores están prohibidos por la especificación |
| Marcadores de documento | --- marca el inicio del documento, ... marca el fin del documento; pueden coexistir múltiples documentos en un archivo |
| Tipos de datos nativos | Cadenas, enteros, flotantes, booleanos, nulos, secuencias (listas), mapeos (diccionarios), marcas de tiempo |
| Versión de la especificación | YAML 1.2 (2009, revisada en 2021); reemplaza a YAML 1.1 (2005) y YAML 1.0 (2001) |
| Compatibilidad con JSON | Desde YAML 1.2, cada documento JSON válido es también un YAML válido - JSON es un subconjunto estricto |
| Comentarios | Comentarios de una sola línea introducidos por # ; pueden aparecer en su propia línea o en línea después de un valor |
| Cadenas multilínea | El escalar de bloque literal (|) preserva los saltos de línea; el escalar plegado (>) convierte los saltos de línea en espacios |
| Anclas y alias | & define un ancla con nombre y * hace referencia (alias) a ella, permitiendo la reutilización de valores sin duplicación |
| Desarrolladores | Clark Evans, Ingy döt Net, Oren Ben-Kiki |
| Casos de uso comunes | Archivos de configuración (Kubernetes, Docker Compose, GitHub Actions, Ansible), serialización de datos, definiciones de OpenAPI |
| Comillas | Se admiten cadenas sin comillas, con comillas simples ('...') y con comillas dobles ("..."); las comillas dobles permiten secuencias de escape |
| Lanzado | 2001 (YAML 1.0); YAML 1.1 (2005); current YAML 1.2 (2009, revised 2021) |
| Estándar abierto | Sí · libre de regalías |
| Especificación | yaml.org |
Conversiones de YAML
Posible
.YAML .JSONGUÍA
Sí - YAML y JSON comparten el mismo modelo de datos, por lo que la conversión es sin pérdidas; solo se…
Cómo convertir
.YAML .XMLGUÍA
Sí - tanto YAML como XML describen datos jerárquicos, por lo que la conversión es sencilla, aunque cada clave…
Cómo convertir
.YAML .TOMLGUÍA
Sí, YAML se puede convertir a TOML; el método más rápido es un comando yq: yq -o=toml file.yaml > file.toml.
Cómo convertir
.YAML .CSVGUÍA
Sí - pero solo cuando el archivo .yaml es una lista plana y uniforme de registros; las configuraciones…
Cómo convertir
.YAML .YMLGUÍA
Sí - .yaml y .yml son el mismo formato; cambiar el nombre del archivo es todo lo que necesita hacer.
Cómo convertir
No es posible
Preguntas y respuestas de la comunidad
preguntado por usuarios
I
Preguntas frecuentes
¿Cuál es la diferencia entre .yaml y .yml?
Ninguna - son el mismo formato YAML con dos extensiones. .yml es la forma antigua de 3 letras. Use la que la herramienta espere; simplemente puede renombrar el archivo.
¿Cómo abro un archivo .yaml?
Con cualquier editor de código o texto. VS Code (con la extensión YAML) es el mejor porque resalta la estructura y señala errores de sangría; Notepad++ y Sublime también funcionan. Es texto plano, por lo que Notepad lo abre, pero no mostrará los espacios en blanco, algo que a YAML le importa.
¿Por qué mi YAML da un error de sangría o de análisis?
YAML utiliza espacios para la estructura y prohíbe los tabuladores, por lo que un tabulador suelto o una línea mal alineada lo rompe. Ábralo en un editor compatible con YAML (que muestre espacios en blanco, convierta tabuladores en espacios) o péguelo en un validador de YAML en línea para encontrar la línea exacta.
¿Cómo convierto YAML a JSON?
Use «yq -o=json archivo.yaml», un comando de VS Code o un convertidor en línea. Es esencialmente sin pérdidas ya que JSON es un subconjunto de YAML; solo se eliminan los comentarios.
¿Puedo usar tabuladores en YAML?
No. YAML solo permite espacios para la sangría; los tabuladores causan un error de análisis. Configure su editor para insertar espacios (por ejemplo, «:set expandtab» en Vim, o «translate tabs to spaces» en Sublime).
¿Es YAML solo para Python?
No - es un error común. YAML es independiente del lenguaje y se usa en todas partes: Docker Compose, Kubernetes, GitHub Actions, Ansible, aplicaciones Go/Java/JS y más. Python simplemente tiene una biblioteca YAML muy popular (PyYAML).
Referencias
1YAML 1.2.2 Specification (yaml.org)yaml.org
2yaml.org - official site & resourcesyaml.org
