Formateador y Validador YAML

YAML utiliza la indentación (espacios) para definir la estructura del documento y el anidamiento; no hay llaves ni etiquetas de cierre como en JSON o XML. El nivel de indentación de un elemento determina si es hijo del elemento anterior o un hermano. Un espacio adicional o faltante puede cambiar completamente el significado: una clave que debería ser una subpropiedad de una definición de servicio podría convertirse en una clave de nivel superior en su lugar, a menudo sin ningún mensaje de error del analizador YAML. Por esto los errores de YAML son notoriamente difíciles de depurar: el síntoma (configuración incorrecta) puede estar lejos de la causa (un espacio perdido en la línea 47).

No. La especificación de YAML prohíbe explícitamente los caracteres de tabulación para la indentación. Las tabulaciones están permitidas dentro de cadenas entrecomilladas, pero nunca como indentación. Si su editor está configurado para insertar tabulaciones cuando presiona Tab, cámbielo a insertar espacios para archivos YAML. Muchos errores relacionados con YAML son causados por tabulaciones invisibles en archivos que parecen estar correctamente indentados. Este formateador detecta y normaliza la indentación de tabulación a espacios.

El formateador maneja el conjunto completo de funciones de YAML 1.2: tipos escalares (strings, integers, floats, booleans, null), mapeos de bloque (key: value), secuencias de bloque (- item), estilo de flujo (inline {} y []), cadenas multilínea (bloque literal | y bloque plegado >), comentarios (#), anclajes (&anchor) y alias (*alias), múltiples documentos (separador ---) y etiquetas de tipo explícitas (!!str, !!int, etc.). Estructuras anidadas complejas como pods de Kubernetes con volúmenes, arrays de env y límites de recursos se formatean correctamente.

Los comentarios son reconocidos durante la validación y el análisis. Durante el formateo, la herramienta vuelve a serializar la estructura de datos analizada; debido a que la mayoría de los analizadores YAML no adjuntan comentarios al modelo de datos, es posible que los comentarios no se preserven completamente en la salida formateada. Para fines de validación (verificación de integridad), los comentarios se manejan correctamente. Si preservar los comentarios exactamente es crítico, copie la versión formateada de vuelta a su editor y vuelva a añadir los comentarios manualmente.

Los errores más frecuentes: (1) Indentación inconsistente — mezcla de indentación de 2 espacios y 4 espacios, o tabulaciones mezcladas con espacios. (2) Claves duplicadas en el mismo mapeo. (3) Strings sin comillas que YAML interpreta como valores especiales — "yes", "no", "true", "false", "null", "on", "off" se interpretan todos como booleanos o null en YAML 1.1 (común en configuraciones antiguas de Kubernetes). (4) Dos puntos sin espacios en claves sin comillas. (5) Falta de espacio después de los dos puntos en pares clave: valor. (6) Strings sin comillas que contienen caracteres especiales de YAML (: { } [ ] # &).

YAML es un superset de JSON; un JSON válido también es un YAML válido. YAML añade funciones amigables para humanos que JSON no tiene: comentarios, strings multilínea, anclajes/alias para reutilizar valores y menos puntuación (sin comas entre elementos de array, sin necesidad de comillas para valores de string simples). JSON tiene ventajas para datos generados por máquinas: no tiene sensibilidad a la indentación, es compatible de forma nativa con todos los lenguajes y es inequívoco. Para archivos de configuración editados manualmente, generalmente se prefiere YAML. Para respuestas de API y almacenamiento de datos, JSON es la opción dominante.

No. Todo el formateo y validación se ejecutan en su navegador usando un analizador YAML de JavaScript. Sus archivos de configuración, que pueden contener variables de entorno, credenciales y detalles de infraestructura, nunca salen de su dispositivo.