YAML online: valida tu texto mientras escribes
Pega tu YAML y este validador lo comprueba mientras escribes. Después explica cada fallo de sintaxis en lenguaje sencillo, con la línea y la columna. Detecta sangrías con tabulaciones, claves duplicadas, comillas y corchetes sin cerrar, y espacios de no separación invisibles que parecen sangría pero no lo son. El YAML se comprueba en tu navegador y nunca se sube.
Validar YAML online paso a paso
Pega o escribe tu YAML en el cuadro YAML. No hay botón de validar: el texto se comprueba en directo.
- El texto pegado se comprueba al instante. Mientras escribes, la comprobación se ejecuta un cuarto de segundo después de tu última tecla, algo más tarde si el texto es muy grande. El resultado anterior se queda atenuado hasta que llega el nuevo.
- Lee el recuadro bajo el editor. Un recuadro verde YAML válido significa que la sintaxis es correcta. Un recuadro rojo YAML no válido (o «YAML no válido: N problemas») enumera lo que falla.
- Cada problema trae una frase, «Línea N, columna M» y un fragmento de la línea con números de línea, dos líneas por encima, una por debajo y un ^ bajo la columna.
- Pulsa Mostrar en el editor para seleccionar esa línea en el cuadro, corrígela y mira cómo el recuadro se pone verde.
Solo se informa del primer error de sintaxis de cada documento. Los siguientes suelen ser efectos secundarios, como unas comillas sin cerrar que se tragan las líneas de debajo. Las claves duplicadas y los alias sin definir se listan siempre todos, y se muestran hasta 20 problemas.
Fallos habituales al validar YAML y cómo arreglarlos
Cada fallo se explica con una frase en lugar de un mensaje crudo del analizador. Estos son los más habituales:
- La línea está sangrada con una tabulación. Un editor insertó un tab, o llegó con lo pegado. Sustituye la tabulación por espacios.
- La línea no está alineada con las demás claves de su mapeo. Una clave tiene un espacio más o menos que sus vecinas. Da a las claves del mismo nivel la misma sangría.
- La sangría es incorrecta. Un bloque anidado no tiene más sangría que su padre. Sangra al hijo más que a la clave padre.
- Una clave aparece más de una vez en el mismo mapeo. Suele ser un bloque copiado que dejó una clave repetida. Fusiona las entradas o borra la repetida.
- La línea no es un par clave: valor. Faltan los dos puntos, o una línea partida no está sangrada. Añade
:tras la clave o sangra la continuación. - Hay un par dentro de otro en la misma línea. Suele ser un segundo dos puntos en un valor sin comillas, como en
a: b: c. Pon el valor entre comillas o usa una línea nueva con sangría. - Un corchete no se cierra nunca, o unas comillas no terminan. El mensaje señala la línea donde se abrió. Añade el cierre.
- Falta una coma entre elementos dentro de
[ ]o{ }. Dos elementos van pegados. Añade la coma. - Un valor empieza por
@o por una comilla invertida. Ponlo entre comillas. - Un
#está pegado a la palabra anterior. Solo inicia un comentario si hay un espacio delante. Añádelo o pon el texto entre comillas. \qno es un escape válido entre comillas dobles. Pasa con rutas de Windows. Escribe\\o usa comillas simples.- Un alias apunta a un ancla que no está definida antes. Define
&nombremás arriba en el archivo. - Esta parte no encaja. Suele ser una lista con
-mezclada con líneasclave: valoren el mismo nivel, o algo sin terminar en la línea de arriba. Pon la lista bajo su propia clave y revisa la línea anterior. - Una directiva
%al principio del documento no es válida o no es compatible. Quítala o usa%YAMLo%TAGcorrectamente.
YAML mapping values are not allowed here y otros mensajes
Si llegas desde un mensaje en el terminal o en un registro de CI, así se corresponden las formulaciones habituales con lo que informa este validador. Pega el mismo archivo y te muestra la línea.
yaml.scanner.ScannerError: mapping values are not allowed here: un segundo dos puntos en una línea, comoa: b: c, un valor sin comillas que contiene:, o una línea sangrada bajo una clave que ya tiene valor.found character that cannot start any token while scanning for the next token: un tab al principio de una línea, o un valor que empieza por@o por una comilla invertida.tabs are not allowed for indent: un tab usado como sangría.did not find expected key: una línea que no se alinea con las demás claves de su mapeo.bad indentation of a mapping entry: una clave sangrada a una profundidad incorrecta.could not find expected ':': una línea sin dos puntos tras la clave.
La redacción cambia entre analizadores (PyYAML, js-yaml, Ruby, Go, los cargadores de Home Assistant y ESPHome), y un analizador suele indicar una línea por debajo del fallo real. Este validador señala la línea que puede mostrarte.
Tabulaciones y caracteres invisibles
Los dos fallos más difíciles de ver en YAML son los que no se ven. Este validador los hace visibles.
- Una tabulación en el fragmento se dibuja como una flecha, y un espacio de no separación o de ancho cero, como un punto.
- Si la línea con el fallo contiene un carácter invisible, una línea extra lo nombra con su punto de código, por ejemplo
U+00A0, y su columna. Cubre espacios de no separación, caracteres de ancho cero, una marca de orden de bytes y espacios de ancho completo. - Cuando el archivo es válido pero una línea empieza con un espacio invisible, aparece un recuadro amarillo Válido, pero revisa esta línea bajo el verde. YAML lee ese carácter como parte de la clave, así que la línea no está realmente sangrada. Lo habitual es que venga de texto copiado de una página web, una wiki o una aplicación de chat.
Un ejemplo: en un archivo con server: y debajo port: 8080, la última línea, host: example.com, empieza con dos espacios de no separación en lugar de dos espacios. YAML la lee como otra clave de primer nivel y host no es hija de server. El recuadro amarillo nombra el carácter y la línea.
Formatear YAML y copiar el resultado
Activa el interruptor Formatear YAML sobre el cuadro. Viene desactivado. Cuando el texto es válido, aparece un bloque YAML formateado con un botón Copiar encima, que cambia a Copiado al copiar. El formato es predecible:
- La sangría es de 2 espacios. No hay otro ancho, y las listas bajo una clave se sangran.
- Se conservan los comentarios, anclas, alias, estilos de comillas y el orden de las claves.
- Las líneas largas nunca se parten.
- Varios documentos mantienen sus separadores
---.
Solo se formatea YAML válido, así que no puede arreglar un archivo roto: corrige antes los fallos. Una salida muy larga se muestra cortada tras 600.000 caracteres, y Copiar sigue copiándola entera.
Validar archivo YAML: usos, tamaño y límites
La comprobación es la misma sea cual sea el uso del YAML. Sirve para flujos de trabajo de GitHub Actions, docker-compose.yml, manifiestos de Kubernetes y valores de Helm, archivos OpenAPI, playbooks de Ansible, la configuración de Home Assistant, plantillas de CloudFormation y la configuración de mkdocs. Pega el archivo antes de hacer commit y los fallos de sintaxis aparecen sin esperar a una ejecución de CI. Un archivo con varios documentos separados por --- se comprueba documento a documento, y el recuadro verde indica cuántos ha encontrado. Se comprueban las anclas (&nombre) y los alias (*nombre). Las etiquetas personalizadas como !Ref, !Sub y !GetAtt de CloudFormation, o !reference de GitLab, se aceptan como válidas.
La comprobación se ejecuta en un Web Worker de tu navegador. Los archivos típicos de configuración, CI y Kubernetes se comprueban en un parpadeo. El límite es de 5.000.000 de caracteres, y un texto cercano tarda unos segundos y usa mucha memoria. Por encima del límite se te pide que pegues un fragmento más pequeño.
Solo se comprueba la sintaxis YAML. No sabe qué espera una herramienta concreta, así que no se comprueban los campos de Kubernetes, las claves de GitHub Actions o Docker Compose ni las reglas de JSON Schema, y un nombre de clave mal escrito sigue pasando. Sigue YAML 1.2, así que las palabras yes, no, on y off de YAML 1.1 son texto normal y nunca se juzgan. No ejecuta, descarga ni carga nada, y un retorno de carro antiguo de Mac suelto no se trata como salto de línea.
¿Trabajas con otros formatos? Ordena y revisa JSON con el Formateador de JSON, compruébalo contra un esquema con el Validador de JSON Schema o revisa marcado con el Validador XML. ¿Buscas un patrón en tu configuración? Pruébalo en el Probador de regex.
Preguntas frecuentes
¿Cómo valido YAML online?
Pega tu YAML en el cuadro «YAML». El texto se comprueba al pegar o escribir, así que no hay botón que pulsar. Un recuadro verde «YAML válido» significa que la sintaxis es correcta. Un recuadro rojo «YAML no válido» da cada problema en lenguaje sencillo, con «Línea N, columna M» y un fragmento de la línea.
¿Por qué YAML dice que las tabulaciones no se permiten para sangrar?
YAML solo permite espacios para sangrar, y una tabulación al principio de una línea es un error de sintaxis. Los editores suelen insertar tabs al pulsar la tecla Tab, o llegan con lo pegado. El validador indica que la línea está sangrada con una tabulación. Sustitúyela por espacios.
¿Qué significa «yaml mapping values are not allowed here»?
Normalmente hay un segundo dos puntos en una línea, como en «a: b: c», o un valor sin comillas que contiene dos puntos. También puede ser una línea sangrada bajo una clave que ya tiene valor. Pon el valor entre comillas o escribe el par interior en su propia línea con sangría.
¿Qué significa «did not find expected key» en YAML?
Una línea no está alineada con las demás claves de su mapeo. Normalmente una clave tiene un espacio más o menos que sus vecinas. Da a todas las claves del mismo nivel la misma sangría. El validador lo indica con un aviso de que la línea no se alinea con las otras claves.
¿Cómo encuentro claves duplicadas en YAML?
Pega el texto. Las claves duplicadas en un mismo mapeo se listan siempre todas, cada una con su línea y su columna. Suele ser un bloque copiado que dejó una clave repetida. Fusiona las entradas o borra la repetida.
¿Por qué un YAML válido muestra «Válido, pero revisa esta línea»?
Una línea empieza con un espacio invisible, por ejemplo uno de no separación. YAML lo lee como parte de la clave, así que la línea no está realmente sangrada aunque el archivo sea válido. El recuadro amarillo nombra el carácter y la línea. Bórralo y escribe espacios normales.
¿Puedo comprobar un YAML de GitHub Actions, Docker Compose o Kubernetes aquí?
Sí, la comprobación de sintaxis es la misma para cualquier YAML. Sirve para flujos de trabajo, docker-compose.yml, manifiestos de Kubernetes y muchos más. Solo se comprueba la sintaxis: el validador no sabe qué claves espera cada herramienta, y un nombre de clave mal escrito sigue pasando.
¿Cuánto puede pesar un archivo YAML que quiera comprobar?
El límite es de 5.000.000 de caracteres. Los archivos de configuración habituales se comprueban en un parpadeo, y un texto cercano al límite tarda unos segundos y usa mucha memoria. Si lo superas, se te pide que pegues un fragmento más pequeño.
Recomendado
-
Yubico Security Key C NFCProtege la cuenta de GitHub o de la nube a la que subes esta configuración.
-
Elgato Stream Deck Neo (8 teclas)Una tecla para lanzar tus comandos de lint, commit y despliegue.
-
Barras de luz inteligentes GoveeLuz suave detrás de la pantalla para arreglar el pipeline de madrugada.
Ayuda a mantener las herramientas gratis. ✨
Imágenes meramente ilustrativas. En calidad de Afiliado de Amazon, obtengo ingresos por las compras adscritas que cumplen los requisitos aplicables.