YAML Formatter & Validator
Understand YAML Formatter & Validator
Este formateador reimprime YAML con una sangría consistente e informa de las estructuras que no puede leer.
How it works
YAML expresa el anidamiento con sangría en lugar de con corchetes, así que el analizador lleva la cuenta de con cuántos espacios empieza cada línea y construye el mapping a partir de ahí. Los valores se tipan después según su texto: true y false son booleanos, null y ~ son null, un número suelto es un número y todo lo demás es una cadena salvo que se entrecomille. La salida se vuelve a serializar a partir de los valores analizados, que es la razón de que vuelva uniforme y también de que desaparezca cualquier comentario del original.
When to use it
- Revisar un workflow de GitHub Actions o un manifiesto de Kubernetes antes de subirlo.
- Encontrar la línea en la que un bloque pegado quedó en un nivel de sangría equivocado.
- Normalizar la sangría de un archivo de configuración que han editado varias personas.
- Confirmar que un valor que usted quería que fuera una cadena no se está leyendo como número o como booleano.
Watch out for
- Los tabuladores nunca son legales como sangría en YAML. Un único tabulador insertado por el editor es un error de sintaxis en todos los analizadores conformes, y es invisible: es el motivo más habitual de que falle un manifiesto.
- En YAML 1.1, que sigue siendo el valor por defecto en PyYAML y en mucho utillaje antiguo, los valores sin comillas yes, no, on y off son booleanos, de modo que un campo de país con valor NO se convierte en false. Es el problema de Noruega. Esta herramienta sigue YAML 1.2 y los trata como cadenas, así que entrecomíllelos igualmente y ambos coincidirán.
- Los comentarios no se conservan. Reformatear devuelve los datos, no el archivo, así que no pegue el resultado sobre una configuración cuyos comentarios necesite.
- Esto maneja la forma que tienen la mayoría de los archivos de configuración: claves de primer nivel, mappings anidados y listas simples. Las anclas y alias (&defaults, *defaults), los escalares de bloque (| y >) y los archivos multidocumento separados por --- no se reproducen.
Not the right tool for: Validar un manifiesto contra su esquema. La sintaxis puede ser perfecta mientras todos los campos están mal; eso lo comprueban kubeconform, actionlint o el validador de la propia plataforma.
Frequently Asked Questions
¿Por qué mi YAML no es válido?
Errores habituales de YAML: tabuladores en lugar de espacios para la sangría (YAML exige espacios), niveles de sangría inconsistentes, caracteres especiales sin entrecomillar (: { } [ ] , # & * ? | - < > = ! % @ `) y valores especiales como "yes" o "no" tratados como booleanos de forma inesperada.
¿Cómo se incluye un signo de dos puntos en un valor de YAML?
Los dos puntos seguidos de un espacio inician un par clave: valor en YAML. Para incluir unos dos puntos literales en un valor, entrecomille toda la cadena: message: "Error: connection failed", o use un escalar de bloque (|) para valores multilínea.
¿Qué versión de YAML se usa aquí?
Este formateador usa YAML 1.2, que es más estricto que YAML 1.1. A diferencia de 1.1, YAML 1.2 solo trata true/false como booleanos (no yes/no/on/off), lo que lo hace plenamente compatible con JSON.
How to Use YAML Formatter & Validator
- Paste or type your input in the input area above.
- The tool processes your input automatically or click Run.
- Copy or download the result using the action buttons.
- Use Ctrl+Enter to run quickly from the keyboard.