Validador y formateador YAML

Pega YAML para comprobar su sintaxis, localizar errores y obtener una salida limpia y con formato coherente.

Opciones de salida

YAMLentrada

Vacío

YAMLsalida

La salida YAML aparece aquí

Se ejecuta íntegramente en tu navegador: no se sube nada. Se aplican límites de uso razonable (5 MB por entrada, conversiones con límite de frecuencia) para evitar el spam y los bots.

Cargar desde URL

Tu navegador obtiene el archivo directamente, por lo que el servidor debe permitir solicitudes de origen cruzado.

Atajos de teclado

Ctrl / ⌘ + Enter Convertir ahora
Ctrl / ⌘ + S Descargar la salida
Alt + Shift + C Copiar la salida
Alt + Shift + F Reparar y formatear el JSON de entrada
Alt + Shift + S Invertir la dirección
Alt + Shift + T Alternar entre las vistas de código, árbol y mapa
Ctrl / ⌘ + Z Deshacer, incluidos Formatear, Reparar y Borrar
Esc Salir de pantalla completa
Tamaño del texto del editor

Normaliza YAML desordenado

La sangría mezclada, los mapas en línea y las comillas innecesarias se analizan sin problema, pero cuestan de revisar. La salida formateada da a cada archivo la misma forma.

Entrada
services:
    web:
        image: "nginx:1.27"
        ports: [ "80:80" ]
        environment: {LOG_LEVEL: info, DEBUG: 'false'}
Formateado
services:
  web:
    image: nginx:1.27
    ports:
      - '80:80'
    environment:
      LOG_LEVEL: info
      DEBUG: 'false'

Errores comunes de YAML y cómo corregirlos

Estos son los mensajes que verás con más frecuencia, en este validador y en herramientas como kubectl, Helm y docker compose.

Mensaje de errorQué significa y cómo corregirlo
tab characters must not be used in indentation YAML solo permite espacios para la sangría. Sustituye cada tabulador por espacios.
bad indentation of a mapping entry Una clave tiene una sangría distinta de la de sus hermanas, o un valor simple contiene ": ". Alinea la clave con sus vecinas o entrecomilla el valor.
mapping values are not allowed in this context El mismo problema tal como lo informan kubectl y Helm: normalmente un valor sin comillas que contiene ": ", como una URL o una hora. Entrecomilla el valor.
end of the stream or a document separator is expected Un elemento de lista o una clave está en un nivel de sangría incorrecto, por ejemplo una lista seguida de un mapping en el mismo nivel.
unexpected end of the stream within a flow collection Una lista en línea [ … ] o un mapa { … } nunca se cierra. Añade el corchete o la llave que falta.
duplicated mapping key La misma clave aparece dos veces en un mapping. Quita o renombra una de ellas.
unidentified alias Un alias como *defaults se usa antes de su ancla &defaults, o sin ella.

Qué comprueba el validador

Rompe el archivo a propósito con los botones y observa qué comprobación lo detecta.

Sintaxis y sangría

Los tabuladores, las claves desalineadas y las comillas y corchetes sin cerrar se informan con la línea y la columna exactas.

Claves duplicadas

Una clave definida dos veces en el mismo mapping es un error, mientras que algunos analizadores se quedan sin avisar con el último valor.

Anclas y alias

Cada alias debe apuntar a un ancla definida antes en el documento, y las claves de fusión deben hacer referencia a mappings.

Varios documentos

Se analiza cada documento de un archivo separado por ---, y las notas muestran cuántos se encontraron.

Privado por defecto

La validación se ejecuta en tu navegador, así que los secretos de los archivos de CI y de los manifiestos nunca salen de tu equipo.

Más herramientas

Conversores, validadores y guías paso a paso para cada lugar donde se encuentran JSON y YAML.

Preguntas frecuentes

¿Cómo valido YAML online?

Pega tu YAML o suelta un archivo .yaml o .yml. La insignia muestra «YAML válido» o «YAML no válido» mientras escribes. Si el archivo no es válido, obtienes el mensaje de error con la línea y la columna exactas, y la línea se resalta en el editor.

¿Qué hace la salida formateada?

Reescribe los mismos datos con una sangría y un entrecomillado coherentes: estilo de bloque, la sangría que elijas y comillas solo donde hacen falta. Es una forma rápida de normalizar un archivo antes de hacer commit.

¿Se conservan los comentarios en la salida formateada?

No. El validador analiza el YAML como datos y lo vuelve a escribir, y los comentarios no forman parte de los datos. Usa la salida para comprobar la estructura y conserva tu archivo original si sus comentarios importan.

¿Puedo validar un archivo YAML multidocumento?

Sí. Se comprueba cada documento separado por ---, y la salida formateada los mantiene como documentos independientes. Las notas bajo el editor muestran cuántos documentos se encontraron.

¿Comprueba esquemas de Kubernetes o Docker Compose?

Comprueba la sintaxis YAML, no un esquema concreto. Un archivo puede ser YAML válido y aun así ser rechazado por kubectl o docker compose por un campo desconocido. Usa kubectl apply --dry-run=server o docker compose config para comprobar el esquema.

¿Qué versión de YAML se usa?

El análisis sigue el esquema core de YAML 1.2, así que yes, no, on y off siguen siendo cadenas. Con «Seguro para YAML 1.1» activado, la salida entrecomilla esas palabras para que los analizadores más antiguos, como PyYAML, también las lean como cadenas.