Formateador de YAML

Da formato a YAML con una sangría uniforme, o conviértelo a JSON. Detecta tabulaciones mezcladas e inconsistencias en la sangría.

Consejos

  • Esta herramienta usa un analizador ligero propio, compatible con pares clave: valor, anidamiento, listas y la sintaxis en línea [a, b, c] / {a: 1}.
  • Aunque pegues YAML con sangría inconsistente (por ejemplo, 3 o 5 espacios), se volverá a generar con una sangría uniforme de 2 o 4 espacios siempre que se analice correctamente.
  • En el modo "Convertir a JSON" puedes previsualizar tu YAML convertido directamente a JSON, útil para compararlo con configuraciones de CI o respuestas de API.
  • Si aparece un error, se muestra el número de línea, así que revisa esa línea por problemas de sangría o un espacio faltante después de los dos puntos.
  • YAML prohíbe la sangría con tabulaciones. Activar "convertir tabulaciones a espacios" en tu editor te ayuda a evitar por completo este problema.

Preguntas frecuentes

YAML es adecuado para archivos de configuración que las personas editan y revisan a mano (configuraciones de CI, manifiestos de Kubernetes, etc.), ya que admite comentarios y se lee de forma más natural. JSON es más adecuado para la comunicación entre programas, como las respuestas de API, ya que es menos ambiguo y se analiza más rápido.

La especificación de YAML prohíbe usar tabulaciones para la sangría. La mayoría de los analizadores lo tratarán como un error de sintaxis y detendrán el procesamiento. Lo más seguro es configurar tu editor para que convierta automáticamente las tabulaciones en espacios.

No. Esta herramienta se centra en el "subconjunto común" que se usa habitualmente en Docker Compose, GitHub Actions y archivos similares (mapeos, listas, colecciones en línea y tipos escalares básicos), y no admite funciones avanzadas como anclas, alias, múltiples documentos o escalares de bloque (|/>).

Es una trampa muy conocida: escribir no, yes, on u off sin comillas se interpreta como booleano en muchas implementaciones de YAML, en lugar de como una cadena de texto normal (como el código de país de Noruega). Si quieres que se trate como cadena, enciérralo entre comillas, por ejemplo "no".
ツールくん

Curiosidad — Por qué YAML se convirtió en el formato de configuración de referencia

YAML (YAML Ain't Markup Language) es un formato de serialización de datos que apareció en 2001. Como no requiere etiquetas de cierre y se ve mucho más simple que XML, se ha convertido en la opción estándar para archivos de configuración de infraestructura desde la década de 2010: Docker Compose, GitHub Actions y los manifiestos de Kubernetes lo utilizan.

Dicho esto, el diseño de YAML de "estructura mediante sangría" es fácil de leer para las personas, pero también frágil: la sangría se rompe fácilmente al copiar y pegar. En particular, mezclar tabulaciones y espacios puede hacer que muchos analizadores produzcan silenciosamente una estructura incorrecta sin generar ningún error, lo que lo convierte en una fuente frecuente de errores de configuración no intencionados.

También existe una trampa muy conocida llamada el "problema de Noruega". Escribir el código de país no sin comillas se interpreta como el booleano false en muchas implementaciones de YAML. Las diferencias entre YAML 1.1 y 1.2 sobre qué cadenas cuentan como booleanos también son una fuente frecuente de problemas de compatibilidad entre implementaciones.

→ Ver todas las curiosidades