YAML es el formato de configuración por defecto de Docker Compose, Kubernetes, pipelines de CI/CD y Ansible, y el formatador YAML gira en torno a la pregunta de volver a hacer legibles esos archivos. Pega cualquier documento YAML, elige uno de los dos modos y la herramienta vuelve a emitir el documento completo con espaciado consistente, enteramente dentro de tu navegador. Nada se guarda ni se sube; el analizador y el serializador corren en tu máquina.
Pega YAML y elige un modo
No hay reformateo en vivo: el documento se procesa solo cuando pulsas un botón. Formatear es el modo por defecto y reconstruye el documento en estilo bloque, el esquema de una clave por línea que usan la mayoría de los archivos de configuración. Minimizar apunta a otro objetivo: producir la representación más compacta que el analizador puede leer. Un selector de sangría pequeño cambia Formatear entre 2 y 4 espacios; aparece solo en modo Formatear porque Minimizar usa siempre 2.
Qué hace Formatear: un documento limpio en estilo bloque
Formatear normaliza todos los niveles del documento a la sangría que elegiste. Los mapeos y secuencias anidados se alinean a desfases fijos, los espacios finales desaparecen y un nivel siempre equivale a un paso de sangría. Los valores largos nunca se doblan: un valor de 400 caracteres se queda en una sola línea, porque en los archivos de configuración la legibilidad de la estructura importa más que la longitud de línea.
Qué hace Minimizar: estilo flow bajo un nivel superior en bloque
Minimizar no aplasta el documento en una sola línea, y eso sorprende. El nivel superior se queda en estilo bloque, pero cada valor bajo una clave superior se escribe en forma flow: una lista de cadenas se vuelve items: [a, b] y un mapeo anidado se vuelve a: {b: [1, 2]}. Una lista de mapas en el nivel superior se convierte en un mapa flow por línea, empezando con un guion y una llave de apertura. Los valores que podrían malinterpretarse en flow, como una clave llamada y, se ponen entre comillas para conservar el sentido exacto.
Qué descarta y reescribe el formador
Tres cosas conviene saber antes de comparar la salida. Los comentarios se descartan: el analizador convierte primero el documento en una estructura de datos y los comentarios no sobreviven a ese paso. Las anclas y los alias se entienden durante el análisis, pero el serializador está configurado para no emitir referencias, de modo que cada alias vuelve como una copia completa del valor al que apunta. Los números también se normalizan: 3.0 pasa a ser 3, 1e5 pasa a ser 100000, 0x10 pasa a ser 16, y los valores vacíos, las tildes y null se imprimen como null, mientras una cadena vacía sigue siendo una cadena vacía, entre comillas.
Orden de las claves: se conserva, con una excepción
El formador no ordena tus claves. Las claves de cadena conservan exactamente el orden que tenían en tu documento, así que un archivo que lista zebra, ant y m vuelve en ese mismo orden. Hay una excepción que puede parecer ordenación: una clave que parece un entero, por ejemplo 123, se mueve al principio del mapeo. No es que el formador elija un orden; es la forma en que el objeto de JavaScript que contiene el documento analizado enumera sus propiedades, y las claves numéricas van siempre primero.
Mensajes de error con línea y columna
Un YAML inválido no produce un fallo vago. El analizador informa del problema con un número de línea y de columna, ambos empezando en 1, para que saltes directo al punto roto. Las claves duplicadas se rechazan de la misma manera, lo cual ayuda cuando un bloque copiado se cuela dos veces. Un caso es distinto: un segundo marcador de documento en la entrada también es un error, pero ese mensaje no tiene posición, porque el analizador se detiene a nivel de flujo. No pegar nada muestra su propio mensaje dedicado.
Intercambiar, limpiar y a dónde ir después
Dos controles pequeños cierran el flujo. El botón Intercambiar aparece cuando hay salida y la copia de vuelta en la entrada, limpiando la salida, lo que acelera la corrección iterativa: formatear, notar un valor que quieres rehacer, intercambiar, editar, formatear otra vez. Limpiar vacía ambos lados y la línea de error. Nada de la página se guarda, así que el contenido sensible de configuración nunca sale de tu navegador. Si tus datos nacen como JSON, pasa antes el Formatador JSON o ve directo al Convertidor JSON/YAML. Las configuraciones XML reciben el mismo trato en el Formatador XML, y para archivos de marcado la guía del formatador HTML cubre el mismo patrón de formato y minimizado con bloques de script protegidos.