Cómo revisar un archivo YAML y leer su vista JSON

Pega una configuración YAML en el cuadro y pulsa Validar. La revisión se ejecuta en el navegador —no se sube nada— y responde con una línea por problema: la indentación con tabuladores y una clave repetida dentro del mismo mapeo son errores, los espacios finales son avisos, y las anclas, claves de fusión y etiquetas se marcan como YAML avanzado que necesita un analizador completo.

El documento interpretado aparece junto al informe en forma de JSON, con el número de líneas, de valores leídos, de problemas y el tamaño de la entrada encima. Copiar lleva ese JSON al portapapeles y Descargar lo guarda como validated-yaml.json; ambos responden con un aviso hasta que una ejecución haya producido algo.

  1. Pega el texto YAML. La página no tiene selector de archivos, así que un archivo del disco hay que abrirlo en un editor y pegarlo, o empezar con Cargar ejemplo, una definición de servicio de diez líneas.
  2. Pulsa Validar. El ejemplo informa de 10 líneas, 10 valores leídos y 0 problemas; un documento de 2.401 líneas se sigue analizando en unos seis milisegundos.
  3. Lee el informe de validación bajo la vista previa: cada entrada empieza por su número de línea, los errores se marcan en rojo y los avisos como los espacios finales en ámbar.
  4. Cuando se informa de un error de análisis, el panel JSON queda vacío: corrige la línea que indica el mensaje y valida otra vez.

Qué hace la vista previa con cada valor

Claves duplicadas, indentación y espacios

Una clave escrita dos veces dentro del mismo mapeo es un error y el mensaje indica la línea de la segunda: host repetido bajo server: se lee como 2: clave duplicada "host"., y un mapeo en línea como {a: 1, a: 2} se detecta igual. Un campo que se repite una vez por registro no es un duplicado: la misma entrada - name: en tres elementos de rules no se señala, porque cada elemento de lista abre su propio mapeo.

La indentación con tabuladores es un error en cada línea que la usa y los espacios finales se avisan línea por línea; ambos cubren todo el documento en una pasada. El analizador se detiene en el primer fallo, así que un documento con varios errores de sintaxis muestra un mensaje de análisis cada vez.

Cómo se leen los valores

Los mapeos, las secuencias, los valores en línea [1, 2] y {a: 1}, los comentarios, las claves entrecomilladas, las cadenas con comillas simples y dobles (un \n entre comillas dobles se convierte en salto de línea) y los bloques literales | y plegados > se leen como pretende el archivo. La vista previa mantiene separados los tipos JSON: 42 y 0.5 son números, true, yes y off son booleanos, null, ~ y un valor vacío pasan a null, y 2026-08-29 sigue siendo texto.

La forma de escribirlo decide el tipo: 007 y 0755 conservan sus ceros iniciales como texto, 0xFF y 1.2.3 siguen siendo texto y 1.10 se lee como el número 1.1. Un número de cuenta de 20 dígitos sin comillas se lee como número y cambia en sus últimas cifras (12345678901234567890 se muestra como 12345678901234567000), así que un id, una versión o un número de cuenta que deba sobrevivir al viaje de ida y vuelta va entre comillas.

Dónde se detiene el analizador

Las claves de fusión se conservan para su revisión en lugar de expandirse: <<: *base permanece en la vista previa como clave literal y su línea se señala. Un segundo documento después de ---, una línea que no es un mapeo clave: valor, una lista en línea sin cerrar con ], una cadena entrecomillada sin terminar y un alias cuya ancla no está definida se informan como errores con su número de línea, y no se muestra JSON hasta corregirlos.

Herramientas recientes: