Ayuda

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.

  1. 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.
  2. 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.
  3. 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.
  4. 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:

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.

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.

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:

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

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.