{"canonical_url":"https://engineer.company/es/glossary/yaml/","content_markdown":"# YAML\n\n## Qué es\n\nYAML es un formato de texto para datos anidados que indica la estructura\ncon sangría, dos puntos y guiones en lugar de corchetes y comillas. Por eso\nes una elección habitual para la configuración que las personas escriben\ny revisan a mano. El nombre es un acrónimo recursivo: «YAML Ain't Markup\nLanguage». Los archivos terminan en `.yaml` o `.yml`. RFC 9512, publicado\nen febrero de 2024, registró el tipo de medio `application/yaml` y señaló\n`.yaml` como extensión preferida.\n\nBajo esa puntuación ligera hay un modelo de datos pequeño. Tiene mapas,\nque asocian claves y valores; secuencias, que son listas ordenadas; y\nescalares: cadenas, números, booleanos y null. Alrededor de ese modelo, el\nlenguaje añade lo que necesita quien edita un archivo: comentarios que\nempiezan con `#`, escalares de bloque que conservan saltos de línea con `|`\no los pliegan con `\u003e`, varios documentos en un archivo separados por `---`,\nanclas y alias (`\u0026name` y `*name`) que permiten reutilizar un valor en otro\nlugar y etiquetas que nombran un tipo de forma explícita.\n\nEl primer framework de YAML se escribió en Perl en 2001. La versión 1.1 de\nla especificación llegó en 2005 y la 1.2 en 2009, centrada en hacer de YAML\nun superconjunto estricto de JSON y con muchas de las antiguas reglas de\ntipado implícito eliminadas. La revisión 1.2.2, publicada en octubre de 2021,\ncorrigió errores y aclaró el texto sin cambiar el lenguaje. Aun así, mucho\nsoftware sigue leyendo las reglas anteriores: la documentación de Ansible\nseñala que PyYAML y libyaml implementan YAML 1.1.\n\nYAML queda así entre dos vecinos. JSON es su subconjunto estricto, conciso\ny sin ambigüedades, pensado para que los programas intercambien datos. TOML\nes un formato de configuración más plano en el que toda cadena va entre\ncomillas, por lo que el tipo de un valor no se adivina. YAML ofrece más que\nambos, y precisamente esa libertad adicional es donde aparecen sus problemas.\n\n## Por qué importa\n\nLa elección real es qué formato dar a un archivo que las personas mantendrán\ndurante años: descripciones de despliegue, flujos de CI o configuración de\nservidores. Los playbooks de Ansible son YAML, igual que los archivos de\nconfiguración de muchas otras herramientas de infraestructura. Para gran\nparte de ese trabajo, otros ya han elegido el formato y solo queda decidir\ncon qué rigor se escribe.\n\nEl argumento a favor de YAML es la legibilidad. Quien revisa puede leer un\ndiff sin contar llaves; un comentario explica por qué un valor es el que es;\ny un script de varias líneas o un certificado cabe en un escalar de bloque\nsin escapes. A cambio, los espacios tienen significado: una clave con dos\nespacios de sangría de más puede acabar en otro mapa aunque el archivo siga\nsiendo válido. Los tabuladores están completamente prohibidos en la sangría.\nLos valores sin comillas reciben su tipo por cómo se escriben, y esas reglas\ncambian entre 1.1 y 1.2. Las plantillas añaden una segunda sintaxis: en\nAnsible, un valor que empieza con `{{` debe ir entre comillas o el analizador\nlo interpreta como un mapa.\n\nLo que inclina la decisión es cómo se comprobará el archivo. YAML con un\nlinter y el hábito de entrecomillar cadenas es un formato cómodo para la\nconfiguración que un equipo edita en común. Sin ninguna de esas prácticas, un archivo\nválido puede decir algo distinto de lo que pretendía su autor. Para los\ndatos intercambiados entre programas, JSON es la opción predeterminada más segura, y para\nun archivo breve de ajustes con pocos niveles de anidamiento, TOML es más\nsencillo.\n\n## Cómo se aplica en la práctica\n\nEl repositorio de infraestructura de la empresa abarca servicios desplegados accesibles al público\ny configuración de otros componentes, incluidas funciones de\nbase de datos, copias de seguridad, transporte de correo y DNS. La\nimplementación registrada comprendía [19 playbooks de Ansible y 34 roles,\ncon 12.065 líneas en total](/es/portfolio/servers-you-can-rebuild-from-scratch/):\nes un recuento histórico, no el tamaño actual del repositorio. La\nautomatización de copias y correo tiene un paso de activación operativa\nseparado de su configuración. La composición se expresa como datos, en\nlugar de opciones de línea de comandos. Cada equipo pertenece a un grupo de nivel, y las\nvariables YAML del grupo enumeran sus roles. Por ello, una ejecución de\naprovisionamiento no necesita argumentos para llevar cada equipo al estado\nque declara su grupo. Aquí YAML es el lenguaje del estado declarado, y el\nresultado se comprueba en lugar de darse por hecho: un equipo ya convergido debe notificar cero cambios.\nYAML cuesta tiempo; cada cambio tarda más que editar un archivo en el\nservidor. Como una convergencia aplicada a medias es peor que una que se\nniega a empezar, ahora se ejecuta antes un play de comprobaciones previas.\n\nDoce mil líneas de YAML necesitan que las lea una máquina antes que una\npersona. En la etapa documentada de implementación de agosto de 2026,\n[YAML era uno de los lenguajes que comprobaba un control de commits con\n22 linters](/es/portfolio/built-a-22-linter-commit-gate/), junto con HTML,\nCSS, JavaScript, Python, Markdown y shell. El control no tiene nivel de\nadvertencia: todo diagnóstico detiene el commit, y las supresiones dentro\ndel código están prohibidas por completo. Un comentario para ignorar una\nregla o una directiva que la desactive en el archivo no ofrece una vía para\neludir el control.\nPara YAML esto importa porque la mayoría de las trampas siguientes son\nsintaxis perfectamente válida; solo una regla que las rechaza las detecta\nantes de que lleguen a un equipo.\n\n## Dónde surgen los problemas\n\nLas trampas siguientes tienen algo en común: el archivo se analiza sin\nerrores y significa otra cosa.\n\n**Un código de país se convierte en false.** Bajo las reglas de YAML 1.1,\n`yes`, `no`, `on`, `off`, `y` y `n` sin comillas son booleanos en varias\ncombinaciones de mayúsculas y minúsculas. El esquema básico de YAML 1.2\nsolo conserva `true` y `false`, con tres combinaciones de mayúsculas y minúsculas. RFC\n9512 advierte que un analizador que siga la sintaxis antigua puede leer\n`{insecure: n}` como false en lugar de como la letra n. Una lista de países\nnórdicos muestra el problema:\n\n```yaml\ncountries:\n    - DK\n    - SE\n    - NO # YAML 1.1 reads this as false\n```\n\nPonga entre comillas cualquier cadena que pueda interpretarse como otra\ncosa, escriba los booleanos solo como `true` y `false` y deje que un linter\nhaga cumplir ambas reglas.\n\n**Un número de versión pierde un dígito.** Los números sin comillas se\nconvierten, de modo que `version: 1.10` llega como el número de coma flotante\n1,1. Bajo las reglas de 1.1, un cero inicial indica un número octal, así\nque un código escrito como `010` se convierte en 8. La documentación de\nAnsible pide entrecomillar una versión como `\"1.0\"` precisamente por este\nmotivo. Ponga entre comillas identificadores, códigos y versiones: son\ncadenas que contienen dígitos.\n\n**Una clave acaba bajo el elemento padre equivocado.** La sangría determina\na qué mapa pertenece una clave; una línea desplazada dos espacios mueve un\najuste a otro lugar sin ningún error. La especificación exige además que\ncada clave de un mapa sea única. Una clave repetida mucho más abajo en un\nbloque largo es fácil de pasar por alto durante la revisión, por lo que\nyamllint incluye una regla para cada uno de esos dos errores. Ejecútelo\nantes de utilizar el archivo.\n\n**Cargar un archivo ejecuta código.** Las etiquetas pueden nombrar tipos\nespecíficos de un lenguaje. Un cargador que las respete construirá el objeto\nque pida el archivo. Según la documentación de PyYAML, usar `yaml.load` con un cargador no seguro\nes comparable a usar `pickle.load`: puede construir objetos e invocar\nfunciones de Python. La elección del cargador importa; las versiones\nactuales exigen indicarlo de forma explícita. `yaml.safe_load` solo reconoce\netiquetas básicas de YAML. RFC 9512 pide desactivar de forma predeterminada\nla ejecución de código en los deserializadores. Use el cargador seguro\npara los archivos de configuración corrientes.\n\n**Un archivo corto llena la memoria.** Las anclas y los alias convierten\nun documento YAML en un grafo en lugar de un árbol. Si cada ancla repite dos veces la anterior,\ncada línea añadida duplica el tamaño: treinta líneas cortas describen más\nde mil millones de cadenas cuando un programa recorre el resultado como\nun árbol ordinario. RFC 9512 lo llama expansión exponencial de datos, el\nataque billion laughs, y propone procesadores que limitan la profundidad\nde recursión de las anclas. Acepte YAML externo solo mediante uno de esos\nprocesadores y pruebe el límite en el analizador que realmente utiliza.\n\n## Lecturas adicionales\n\n- [YAML 1.2.2 specification](https://yaml.org/spec/1.2.2/) — el propio\n  lenguaje, incluido el esquema básico que determina el tipo de los valores\n  sin comillas.\n- [RFC 9512: YAML Media Type](https://www.rfc-editor.org/rfc/rfc9512) —\n  registro de `application/yaml`, con notas de seguridad sobre booleanos,\n  ejecución de código y expansión de alias.\n- [YAML specification changes](https://yaml.org/spec/1.2.2/ext/changes/) —\n  cambios de cada revisión, de 1.2.1 a 1.2.2.\n- [Ansible: YAML Syntax](https://docs.ansible.com/ansible/latest/reference_appendices/YAMLSyntax.html)\n  — subconjunto que utiliza Ansible y sus problemas con las comillas.\n- [yamllint rules](https://yamllint.readthedocs.io/en/stable/rules.html) —\n  comprobaciones de valores interpretados como verdaderos, claves duplicadas,\n  números octales y sangría.\n- [PyYAML documentation](https://pyyaml.org/wiki/PyYAMLDocumentation) —\n  diferencia entre `load` y `safe_load`, explicada por la propia biblioteca.\n\n\u003chttps://engineer.company/es/glossary/yaml/\u003e\n","date_modified":"2026-11-09T21:50:25Z","description":"Qué es YAML, cuándo elegirlo frente a JSON o TOML para un archivo editado a mano y las trampas de booleanos, sangría y cargadores no seguros.","formats":{"gemtext":"https://engineer.company/es/glossary/yaml/index.gmi","gopher":"https://engineer.company/es/glossary/yaml/gophermap","html":"https://engineer.company/es/glossary/yaml/","json":"https://engineer.company/es/glossary/yaml/index.json","markdown":"https://engineer.company/es/glossary/yaml/index.md","pdf":"https://engineer.company/es/glossary/yaml/index.pdf"},"kind":"page","language":"es","title":"¿Qué es YAML?","url":"https://engineer.company/es/glossary/yaml/","version":1}