Formateador y Validador YAML - Corrige la indentación, encuentra el error
Formateador y validador YAML
Qué hace esta herramienta
YAML no tiene llaves: la estructura la lleva la indentación. Eso lo hace agradable de leer y fácil de romper: un espacio de más y una clave acaba bajo el padre equivocado. Esta herramienta reindenta el documento a un ancho único, te dice dónde está roto y muestra cómo se está leyendo de verdad.
Cómo usarla
- 1 Pega tu YAML en el cuadro y elige el ancho de sangría: dos espacios es lo habitual.
- 2 Pulsa Formatear para reindentar, o Validar para comprobarlo sin cambiar ni un carácter.
- 3 ¿No estás seguro de que un valor se lea como querías? Pulsa A JSON y míralo.
Los tabuladores no son indentación
La especificación de YAML prohíbe los tabuladores en la indentación, y la mayoría de los analizadores rechazan el archivo sin más. Su mensaje rara vez ayuda, porque la línea que señalan suele ser la siguiente al problema real. Esta herramienta nombra la línea donde está el tabulador.
Tus comentarios se conservan
Muchos formateadores analizan el documento como un árbol y lo vuelven a imprimir. Queda ordenado, y borra todos tus comentarios, lo que lo hace inservible para un docker-compose o un pipeline de CI. Este solo reescribe el espacio inicial: comentarios, orden de claves y estilo de comillas quedan tal como los dejaste.
Por qué NO se convirtió en false
En YAML 1.1, las palabras sueltas yes, no, on y off eran booleanos. Una lista de países con el código NO de Noruega se cargaba, por tanto, como false: un fallo tan famoso que tiene nombre propio. YAML 1.2 eliminó esa regla y esta herramienta sigue la 1.2: solo true, false y null son palabras clave. Si quieres un booleano, escribe true o false; si quieres el texto, ya lo tienes.
Anclas, alias y escalares de bloque
Un ancla (&nombre) marca un nodo para que un alias (*nombre) lo reutilice más adelante: útil con definiciones de servicio repetidas. Los escalares de bloque (| y >) llevan texto multilínea: la barra vertical conserva tus saltos de línea, el ángulo los pliega en espacios. Los tres se entienden aquí, y la indentación dentro de un escalar de bloque se trata como dato, no como formato.