Validador y formateador de YAML
Pega YAML de un archivo Docker Compose, un workflow de GitHub Actions, un manifiesto de Kubernetes o cualquier archivo de configuración. El validador lo comprueba mientras escribes, explica cada error con palabras sencillas, con la línea y la columna, y avisa de valores que otras herramientas pueden leer de otra forma. El YAML válido se convierte a JSON o a YAML bien formateado. No se sube nada.
Gratis · Sin registro
Cómo usarla
- Pega tu YAML, abre un archivo .yaml o .yml, o carga uno de los ejemplos.
- Lee el estado bajo el cuadro. Si es válido, verás el número de claves y documentos; si hay un error, la línea, la columna y qué corregir.
- Pulsa Mostrar en la entrada para ir al error y revisa los avisos sobre valores como yes o 0755 que otras herramientas pueden leer distinto.
- Elige JSON o YAML formateado, la sangría, y copia o descarga el resultado.
Por qué usar esta herramienta
Ubicación exacta del error
Cada error muestra la línea y la columna, un fragmento con una marca y una explicación en lenguaje claro.
Avisos más allá de la sintaxis
Detecta yes y no, ceros iniciales, números de versión y espacios que faltan tras los dos puntos antes de que causen fallos.
YAML a JSON
Convierte YAML válido a JSON con 2 o 4 espacios o en forma compacta. Varios documentos se convierten en un array JSON.
Formateador de YAML
Vuelve a sangrar YAML desordenado de forma uniforme y ordena las claves alfabéticamente.
Listo para configuraciones reales
Funciona con Docker Compose, GitHub Actions, Kubernetes, Ansible y OpenAPI, incluidos documentos separados por ---.
Privado
La validación se hace en tu navegador, así que los secretos de tus configuraciones nunca se suben.
Los errores de YAML más comunes
| Error | Causa | Solución |
|---|---|---|
| Sangría incorrecta | Una clave o elemento tiene más o menos espacios que sus vecinos | Alinea los elementos del mismo nivel con el mismo número de espacios |
| Tabuladores en la sangría | La línea está sangrada con un tabulador | Cambia los tabuladores por espacios |
| Clave duplicada | La misma clave aparece dos veces en un mapa | Elimina o renombra una de ellas |
| Falta el espacio tras los dos puntos | Se escribe clave:valor sin espacio | Escribe clave: valor |
| Dos puntos dentro de un valor | Un valor como Nota: importante contiene ": " | Pon el valor entre comillas |
| Comilla o corchete sin cerrar | Se abre un " ' [ o { y no se cierra | Añade el carácter de cierre |
Valores que sorprenden
YAML adivina el tipo de los valores sin comillas. En YAML 1.1, que usan PyYAML, Ansible y muchas herramientas antiguas, yes, no, on y off se convierten en true o false, así que un código de país como NO (Noruega) se vuelve false. Los números con ceros iniciales como 0755 pueden leerse como octales, y una versión como 1.10 se convierte en el número 1.1.
Este validador sigue YAML 1.2, que es más estricto, y te avisa de estos valores. La regla segura: pon entre comillas todo lo que deba seguir siendo texto, como versiones, códigos, teléfonos y códigos postales.
YAML frente a JSON
| YAML | JSON | |
|---|---|---|
| Comentarios | Sí, con # | No |
| Estructura | Sangría | Llaves y corchetes |
| Comillas | Normalmente opcionales | Obligatorias para claves y textos |
| Varios documentos en un archivo | Sí, separados por --- | No |
| Uso típico | Archivos de configuración escritos por personas | Datos que intercambian los programas |
Privacidad
Los archivos de configuración suelen contener contraseñas, tokens y nombres de servidores internos. Esta herramienta analiza tu YAML en el navegador con la biblioteca de código abierto js-yaml y nunca lo envía a ningún sitio. Tu última entrada se guarda solo en este navegador, para que siga ahí cuando vuelvas.
Preguntas frecuentes
¿Cómo compruebo si mi YAML es válido?
Pégalo en el cuadro de arriba. La línea de estado te dice al instante si es válido. Si no, muestra la línea y la columna del primer error y qué cambiar.
¿Por qué mi YAML dice sangría incorrecta?
Los elementos del mismo nivel deben empezar exactamente en la misma columna. Normalmente a una línea le sobra o le falta un espacio, o un elemento de lista no está alineado con los de arriba.
¿Puedo usar tabuladores en YAML?
No. YAML solo permite espacios para la sangría. Al pulsar Tab en este editor se insertan dos espacios.
¿Comprueba las reglas de Kubernetes o Docker Compose?
Comprueba la sintaxis YAML y los fallos habituales, no el esquema de una herramienta concreta. Un archivo puede ser YAML válido y tener un campo de Kubernetes mal escrito.
¿Cómo convierto YAML a JSON?
Pega YAML válido, deja JSON seleccionado a la derecha y pulsa Copiar resultado o Descargar. Un archivo con varios documentos --- se convierte en un array JSON.
¿Se conservan los comentarios al formatear?
No. El YAML formateado y el JSON se generan a partir de los datos, así que no se conservan comentarios ni anclas. Tu texto original en el cuadro izquierdo no cambia.
Guía de sintaxis YAML con ejemplos
Herramientas relacionadas
¿Necesitas crear algo?
Cuéntanos qué quieres construir.
Cuéntanos qué necesitas crear, desde una web sencilla hasta una app completa, una solución de IA, una automatización o un sistema a medida.