Saltar al contenido

Formateador YAML

Valida y reformatea YAML con indicación clara de errores de línea y columna.

Entrada

Formateador YAML

YAML aparece en todas partes: desde manifiestos de Kubernetes hasta flujos de trabajo de GitHub Actions y archivos de configuración de aplicaciones. Es implacable con los espacios en blanco: un único espacio mal alineado arruina todo el documento. Esta herramienta verifica la sintaxis de un documento YAML y lo reformatea consistentemente para que puedas detectar un pipeline roto o archivo de configuración defectuoso antes de que se ejecute.

Pega un documento y se analiza instantáneamente. La entrada válida se devuelve reformateada con el ancho de sangría que elijas; la entrada inválida devuelve la línea y columna exactas del problema junto con lo que esperaba el analizador, así que no tendrás que adivinar cuál de las cuarenta líneas tiene la tabulación perdida. Dos verificaciones se ejecutan automáticamente en cada documento válido: una advertencia si alguna línea usa tabulación para sangría (la especificación YAML la prohíbe aunque muchos editores la insertan por defecto) y un recuento de claves duplicadas dentro del mismo mapeo (YAML lo permite, pero generalmente significa que solo la última gana y las otras son peso muerto).

Las opciones controlan tanto la forma como el espacio en blanco. Ordena las claves alfabéticamente para obtener un documento determinista y comparable, útil cuando la configuración generada produce continuamente diffs de git ruidosos sin razón funcional. Contraer listas cortas convierte una secuencia escalar como una lista de etiquetas de tres líneas en una única línea de estilo flujo como tags: [a, b, c]; déjalo desactivado y cualquier lista de flujo en línea en la entrada se expandirá a un elemento por línea, que generalmente es más fácil de revisar y fusionar. Eliminar comentarios quita tanto comentarios de línea completa como comentarios hash finales para una versión minificada, mientras que mantenerlos activados preserva los comentarios de tu documento exactamente como están escritos.

El formateo se ejecuta completamente en tu navegador. El YAML que pegas nunca se carga, registra ni se envía a ningún lado: se analiza, reformatea y se muestra localmente, y desaparece cuando cierras o recarga la pestaña.

Preguntas frecuentes

¿Mi YAML se sube a algún lado?
No. El análisis y formateo ocurren completamente en el motor JavaScript de tu navegador. Nada de lo que pegas se envía a un servidor, se registra o se almacena fuera de tu dispositivo.
¿Qué significan la línea y columna en el error?
Apuntan al lugar exacto en tu documento donde el analizador dejó de entender, contando desde la parte superior e izquierda del texto que pegaste. También indica qué esperaba allí, como sangría consistente o un valor después de dos puntos.
¿Por qué advierte sobre tabulaciones?
La especificación YAML prohíbe usar caracteres de tabulación para sangría: solo se permiten espacios. Un documento con sangría de tabulación puede analizarse inconsistentemente o fallar completamente en una implementación diferente de YAML, por eso la herramienta lo marca incluso si tu entrada aún se analiza aquí.
¿Qué pasa con las claves duplicadas?
YAML permite repetir una clave dentro del mismo mapeo, y la mayoría de analizadores mantienen silenciosamente solo el último valor. La herramienta no lo rechaza, pero cuenta los duplicados y marca la línea afectada para que puedas decidir si fue intencional.
¿Puede arreglar YAML inválido para mí?
No: te dice exactamente dónde falló el análisis para que puedas reparar la fuente. Adivinar automáticamente una reparación para sangría rota arriesgaría cambiar el significado del documento.