Prueba la herramienta gratuita abajo. Funciona en tu navegador, sin registro y sin descarga.
Qué es YAML y por qué da errores
YAML es un formato de texto plano que se usa para archivos de configuración, reglas de automatización y ajustes de aplicaciones. Se lee con facilidad, pero es estricto con los espacios: un sangrado mal puesto puede romper un archivo entero. Esta herramienta revisa tu YAML y lo reescribe con un diseño limpio y uniforme, para que encuentres los errores rápido y compartas un archivo ordenado.
La herramienta usa js-yaml, una biblioteca conocida de YAML, y todo se hace en tu navegador. Tu texto nunca sale de tu dispositivo, algo importante cuando un archivo de configuración contiene nombres de servidores, datos de proyectos u otros valores privados. Pega, formatea y copia el resultado.
Cómo se usa
Pega tu YAML en el cuadro y pulsa Formatear. La herramienta lee el texto y, si es válido, lo devuelve con sangrados de dos espacios, un elemento por línea y las listas bien colocadas. Si no es válido, muestra el mensaje de error del analizador, que normalmente señala la línea y el problema, como un sangrado incorrecto o una tabulación fuera de lugar.
Pulsa Validar cuando solo quieras una respuesta de sí o no sin cambiar tu texto. Eso sirve antes de guardar un archivo o de pegarlo en un servidor, porque una comprobación rápida ahora puede evitar un despliegue fallido después.
Errores habituales en YAML
El error más común es mezclar tabulaciones y espacios. YAML prohíbe las tabulaciones para el sangrado, así que usa solo espacios. El segundo más común es un sangrado desigual: los elementos bajo una misma clave deben alinearse exactamente. Un tercer error frecuente es un valor sin comillas que parece otra cosa, como sí, no o una fecha, que YAML puede leer como un valor lógico o una fecha en lugar de texto.
Es buena costumbre poner entre comillas los valores que se pueden confundir. Si un valor empieza con un carácter especial, contiene dos puntos seguidos de un espacio o parece un número que quieres conservar como texto, usa comillas.
Quién lo necesita
Esta herramienta sirve para desarrolladores que editan flujos de trabajo, archivos de Docker Compose, ajustes de Kubernetes y configuraciones de aplicaciones. También sirve para estudiantes que aprenden YAML y para cualquiera que reciba un archivo de configuración roto y necesite encontrar el fallo rápido.
Como funciona en el navegador una vez cargada la página, se puede usar en un avión, en una reunión o en un equipo donde no se puede instalar programas.
Preguntas frecuentes
¿Mi YAML se envía a un servidor? No. La revisión y el formato se hacen en tu navegador.
¿Qué cambia el formateador? Reescribe los espacios y el diseño. Mantiene tus claves, valores y estructura.
¿Por qué falla mi archivo con un error de tabulación? YAML no permite tabulaciones para el sangrado. Sustitúyelas por espacios.
¿Puedo descargar el resultado? Sí. El botón de descarga guarda el texto formateado como un archivo .yaml.
Un ejemplo práctico: arreglar un archivo roto
Imagina un archivo de ajustes que falla con un error vago. El primer paso es pegarlo en el validador y leer el mensaje exacto, que muchas veces indica un número de línea. Ve a esa línea y revisa el sangrado de todas las líneas de alrededor, contando los espacios con cuidado. Un culpable habitual es un elemento de lista que queda un espacio demasiado a la izquierda o a la derecha, lo que cambia a qué clave pertenece. Otro es una línea que mezcla una tabulación con espacios, que en pantalla parece correcta pero rompe el analizador. Corrige los espacios, valida otra vez y repite hasta que el mensaje desaparezca. Luego pulsa Formatear para reescribir el archivo limpio, y compara la versión formateada con tu original para ver qué cambió. Este ciclo de validar, corregir y formatear otra vez es la forma habitual en que los profesionales limpian YAML, y funciona igual de bien para un archivo de diez líneas que para uno de mil. Guarda la versión formateada como tu archivo definitivo, porque su diseño uniforme hace que la siguiente edición sea más fácil y menos propensa a errores.
Otro hábito ayuda: valida después de cada cambio pequeño, no solo al final. Detectar un error justo después de cometerlo lleva segundos, mientras que buscarlo después en un archivo largo puede llevar mucho más tiempo.
También en inglés
Esta herramienta también está disponible en inglés: YAML Formatter and Validator – Format and Validate YAML Free Online.