Formateador YAML

Sí. El formateador analiza tu documento con un analizador que conserva un árbol de sintaxis concreto, así que los comentarios en su propia línea, los que siguen a un valor y los bloques de comentarios entre secciones salen donde entraron. Si activas el orden de claves, cada comentario permanece unido a la clave sobre la que está. La mayoría de los formateadores en línea convierten el YAML en datos planos y los vuelven a imprimir, y por eso pierden todos los comentarios; el convertidor a JSON de este sitio hace lo mismo, inevitablemente, y te dice cuántos descartó.

La estructura y el texto no se tocan: las comillas quedan exactamente como las escribiste, las anclas, los alias y las claves de fusión siguen en su sitio, los escalares de bloque conservan su contenido y el orden de las claves se mantiene salvo que pidas ordenarlas. Dos cosas se normalizan. Los números sin comillas se imprimen en forma canónica con YAML 1.2, así que 022 pasa a 22, +1 a 1 y 1e3 a 1e+3; cambia la versión a 1.1 y se conservan los octales con cero inicial como 0644. Los escalares plegados (>) se reajustan conservando los saltos de párrafo. Si un valor debe conservar su escritura exacta, ponlo entre comillas: las advertencias bajo la salida enumeran cada valor sin comillas que YAML 1.1 y 1.2 leen de forma distinta.

Dos espacios de forma predeterminada, o cuatro si lo eliges. Cada nivel del documento recibe la misma anchura sin importar cómo estuviera sangrada la entrada, y una secuencia anidada bajo una clave se sangra debajo de esa clave. YAML prohíbe los tabuladores como sangría, así que no hay opción de tabulador, y un documento sangrado con tabuladores se reporta como error con su número de línea en lugar de formatearse.

Sí. La opción Ordenar claves ordena alfabéticamente las claves de cada mapeo, en todos los niveles de anidamiento, lo que facilita los diffs y la revisión de código en archivos que editan varias personas o herramientas. Las secuencias conservan su orden, porque en una lista el orden significa algo. Los comentarios se mueven con la clave a la que pertenecen. La opción está desactivada por defecto: el orden de las claves no significa nada en YAML, pero a menudo significa mucho para quien lee el archivo.

Sí. Un archivo con varios documentos separados por --- se formatea documento a documento y los separadores se conservan, así que un manifiesto de Kubernetes con un Deployment, un Service y un Ingress sigue siendo un solo archivo. También se conservan un --- inicial y una directiva %YAML, y la línea de estado indica cuántos documentos se formatearon.

El formateador usa un analizador más estricto que el convertidor, porque necesita entender la forma exacta del documento para reconstruirlo con los comentarios en su sitio. Un documento que el convertidor analiza pero que aquí falla se reporta con la línea, una explicación en lenguaje claro y una corrección sugerida, igual que en el validador YAML. La guía de errores comunes de YAML repasa los seis fallos que hay detrás de casi todos los análisis fallidos.

No, y se complementan bien. yamllint reporta problemas de estilo y sintaxis pero no reescribe el archivo; este formateador reescribe la sangría y el espaciado pero no impone reglas como la longitud de línea. La salida YAML de Prettier se parece mucho a la que obtienes aquí, y si tu proyecto ya lo ejecuta no necesitas esta página: existe para el archivo que tienes ahora mismo en el portapapeles, sin instalar nada y sin subir nada.

No. El formateador es JavaScript que se ejecuta en la pestaña de tu navegador. La biblioteca yaml se carga con la página y no hay ningún endpoint al que enviar un documento; puedes cargar la página, desconectarte de internet y seguir formateando. Eso importa para los archivos que la gente suele querer ordenar: los manifiestos de Kubernetes, los archivos de Docker Compose y los pipelines de CI contienen nombres de host, registros y algún que otro secreto.

yq -i . config.yaml reformatea un archivo en el sitio y conserva los comentarios; quita -i para imprimir el resultado en su lugar. Con Prettier instalado, npx prettier --write "**/*.{yml,yaml}" formatea todos los archivos YAML de un proyecto. En Python, ruamel.yaml en modo round-trip reformatea conservando los comentarios, algo que PyYAML no puede hacer. Para un archivo suelto, pégalo en el formateador de arriba.