Herramienta para desarrolladores

Formateador de YAML

Pega YAML. Recíbelo limpio o descubre exactamente qué línea está mal.

Formateador de YAML Funciona en tu dispositivo
  • Se ejecuta en tu navegador — tu texto no se envía a ningún sitio
  • Sin registro, sin cuotas, gratis para usar tantas veces como quieras

Cómo funciona

Todo el diseño de YAML se apoya en la sangría, lo que lo hace agradable de leer y inusualmente fácil de romper. Un solo espacio suelto produce un mensaje de error de un pipeline de CI veinte minutos después. Esta herramienta lo analiza aquí y te lo dice de inmediato.

Validación con número de línea

Si el documento no se puede analizar, recibes la línea y la columna donde falló y el motivo del propio analizador. Eso casi siempre es más útil que la salida formateada, y es la razón por la que la mayoría de la gente abre una herramienta como esta.

Reformateo

El YAML válido se analiza como una estructura de datos y se vuelve a escribir desde cero, de modo que la sangría queda uniforme, las comillas se normalizan y desaparecen los espacios sobrantes al final de las líneas. Como pasa por los datos en lugar de editar el texto, se garantiza que el resultado sea válido.

Lo que te cuesta ese proceso

Los comentarios se pierden. No forman parte de los datos, así que el analizador los descarta. Las anclas y los alias se expanden a sus valores completos en lugar de conservarse. Si los comentarios de tu archivo importan, formatea una copia y aplica a mano las correcciones de sangría.

Ordenar las claves

El orden alfabético hace que dos archivos de configuración sean realmente comparables en un diff. También es la opción equivocada para un archivo en el que el orden tiene significado para quien lo lee: un pipeline de CI se lee mejor en orden de ejecución que en orden alfabético.

Varios documentos

Se admite un archivo que contenga varios documentos separados por ---, y cada uno se formatea por turno.

Preguntas frecuentes

Formateador de YAML: preguntas

¿Por qué desaparecieron mis comentarios?

El formateo analiza el YAML como datos y lo vuelve a escribir, y los comentarios no forman parte de los datos. Formatea una copia si necesitas conservarlos.

¿Me dice dónde está el error?

Sí, con la línea y la columna y la explicación del propio analizador.

¿Se sube mi YAML?

No. Se analiza en tu navegador, lo cual importa dada la frecuencia con la que el YAML contiene secretos y detalles de infraestructura.

¿Puede manejar varios documentos en un mismo archivo?

Sí, los documentos separados por --- se formatean uno por uno.

¿Debería ordenar las claves?

Es útil para comparar dos archivos de configuración. No ayuda cuando el orden tiene significado para quien lee.