Formatea, valida e inspecciona documentos YAML con ordenacion de claves y control de expansion de anclas y alias.
Formatea, valida e inspecciona documentos YAML con ordenacion de claves y control de expansion de anclas y alias. Formatea, valida e inspecciona documentos YAML con ordenacion de claves y control de expansion de anclas y alias.
Array
Contexto
Que es YAML y por que un visor es util
YAML ("YAML Ain't Markup Language") es un formato de serializacion de datos amable con humanos, muy usado para archivos de configuracion (docker-compose.yml, manifiestos de Kubernetes, workflows de GitHub Actions, playbooks de Ansible, etc.). Cambia la rigidez de JSON por una estructura basada en indentacion y un sistema de tipos mas rico que incluye fechas, cadenas multilinea y referencias.
Como YAML depende de la indentacion para expresar anidamiento, un espacio faltante puede cambiar el significado de todo el documento, y la mayoria de los editores no resaltan visualmente la jerarquia. Un visor parsea el documento y lo reemite con una indentacion consistente, dejando al descubierto tanto los errores de indentacion como la estructura.
Caracteristicas que conviene conocer
La mayoria de los visores permiten alternar algunos comportamientos: ordenar claves alfabeticamente para diffs estables, expandir o eliminar anclas y alias de YAML (la sintaxis & / *), y elegir el ancho de indentacion. La opcion de ordenar es particularmente valiosa al comparar dos instantaneas de la misma configuracion: sin ella, el reordenamiento de claves entre releases puede ocultar cambios reales.
Las estadisticas de bytes y claves de nivel superior ayudan a ver lo pesado del documento y donde se concentra el peso. Si necesitas saber si tu YAML cabe en un limite de variables de entorno o en el presupuesto de tamano de un ConfigMap de Kubernetes, ese numero esta ahi mismo.
Consejos de flujo de trabajo
Cuando depures un error de parseo, copia el documento en una nueva pestana del visor y alterna las opciones una a una: una sintaxis &anchor puede parecer un typo hasta que la veas expandida. Para pipelines muy largos usa indentacion de 4 espacios para ajustarte a las guias de estilo comunes; para revision inline o pegado en chat, 2 espacios es mas compacto. Conserva siempre la estructura original del documento al hacer commit de la configuracion: un visor sirve para inspeccionar, no para normalizar.
Preguntas frecuentes
Por que YAML parece JSON con pasos extra?
JSON es un subconjunto estricto de YAML 1.2: cada documento JSON es un documento YAML valido. YAML anade comentarios, cadenas multilinea, referencias y un sistema de tipos mas rico encima.
Cual es la diferencia entre anclas (&) y alias (*)?
Un ancla (&name value) marca un valor con un nombre; un alias (*name) reutiliza ese valor en otra parte. El visor puede expandir los alias en linea (*name se convierte en el valor original) o eliminarlos, util para normalizar la salida antes de un commit.
El visor conserva los comentarios al reemitir?
No. La mayoria de las bibliotecas YAML (incluida js-yaml) eliminan los comentarios en un viaje load/dump porque el modelo de datos de YAML no los incluye. Si los comentarios importan, edita el archivo original directamente.
Por que el visor dice que no encuentra un caracter de tabulacion?
YAML no permite tabulaciones para indentacion, solo espacios. Incluso una sola tabulacion dentro de una cadena de bloque puede confundir a algunos analizadores. Reemplaza tabulaciones por espacios y vuelve a intentarlo.
El visor fusiona archivos YAML multi-documento?
Parsea y reemite cada documento por separado, pero el visor actual emite un solo documento a la vez. Para multi-documento usa un editor dedicado.
Mi YAML se sube?
No. El parseo y reformateo ocurre en local mediante la biblioteca js-yaml empaquetada; nada sale del navegador.