pulsa ⌘K para cambiar de herramienta
VALIDATE & INSPECT

Validador YAML

Valida sintaxis YAML y visualiza resultados.

local
yaml-validator
§01 ACERCA DE ESTA HERRAMIENTA

Descripción general

El validador de YAML comprueba la sintaxis en vivo a medida que escribes y, cuando el documento es válido, muestra la estructura analizada como JSON con formato. Usa js-yaml, el mismo analizador que se encuentra en innumerables cadenas de herramientas de Node.js, así que los errores y la inferencia de tipos coinciden con lo que hará tu canalización de compilación. Útil para depurar configuraciones de CI (GitHub Actions, GitLab CI), manifiestos de Kubernetes y archivos de Docker Compose antes de confirmarlos.

Cómo se usa

  1. Pega o escribe tu documento en el campo YAML.
  2. Lee la línea de estado de debajo: Valid YAML si va bien, o el mensaje de error del analizador — con la línea y la columna del problema — si falla.
  3. Cuando sea válido, revisa el panel Parsed (as JSON) para confirmar la estructura y los tipos inferidos.

Ejemplos

Entrada:

server:
  host: localhost
  port: 8080

Parsed (as JSON): { "server": { "host": "localhost", "port": 8080 } }; fíjate en que port es un número, no una cadena.

Un carácter de tabulación usado para indentar produce un error que nombra la línea problemática, ya que YAML prohíbe las tabulaciones en la indentación.

Notas

El validador analiza un único documento; los flujos de varios documentos separados por --- no se informan por completo. La validación cubre solo la sintaxis: no puede saber si las claves son las correctas para la herramienta que consume el archivo (eso requiere un linter que conozca el esquema de ese formato concreto).

Los documentos cuyas anclas y alias se referencian de forma multiplicativa se rechazan antes de analizarlos. Unos cientos de bytes de alias anidados pueden expandirse a cientos de megabytes —253 bytes llegando a 22,8 MB es fácil de construir— y eso congelaría la pestaña. El uso normal de anclas, incluidas las claves de fusión <<: que aparecen por todo Docker Compose y las configuraciones de CI, no se ve afectado. También se rechaza la entrada por encima de 2 MB.

FAQ
¿Se envía mi YAML a un servidor?
No. El análisis se ejecuta en tu navegador mediante la biblioteca js-yaml; los archivos de configuración, los secretos y las definiciones de CI nunca salen de la página.
¿Por qué se muestra el resultado analizado como JSON?
El JSON hace que la estructura analizada quede sin ambigüedades. YAML ofrece muchas formas de escribir los mismos datos, así que ver los objetos, arreglos, cadenas y números resultantes como JSON confirma exactamente cómo interpretará tu documento quien lo consuma.
Mi YAML es válido pero un valor se analizó de forma distinta a lo que esperaba. ¿Por qué?
YAML infiere tipos de manera agresiva: un no sin comillas pasa a false en algunos esquemas, 08 puede fallar como octal, y 1.0 pasa a ser un número. Pon entre comillas los valores que quieras tratar como cadenas y usa la vista previa en JSON para verificar los tipos inferidos.