Puntos clave
- 01Formatea YAML con indentación consistente usando el analizador js-yaml — la misma librería utilizada en las herramientas de compilación de Node.js.
- 02Valida la sintaxis e informa números de línea exactos para errores.
- 03Convierte entre YAML y JSON en ambas direcciones con preservación correcta de tipos.
- 04Nada se sube — toda la operación se ejecuta localmente en tu navegador.
Por qué el formateo YAML es importante para archivos de configuración
YAML es el lenguaje de configuración predeterminado para Kubernetes, GitHub Actions, Docker Compose, gráficos Helm y muchas otras herramientas. También es famosamente sensible a la indentación — una sola línea mal indentada puede producir un desajuste de tipo silencioso o un error de análisis grave que bloquea un despliegue. Formatear regularmente mantiene los archivos consistentes y detecta problemas antes de que lleguen a CI.
Convertir entre YAML y JSON es igualmente útil. Algunas herramientas solo aceptan JSON para llamadas API o definiciones de esquema, mientras que los humanos generalmente prefieren YAML para archivos de configuración de larga duración. Poder convertir entre los dos sin perder tipos de datos — los números siguen siendo números, los booleanos siguen siendo booleanos — ahorra tiempo y previene errores sutiles.
Cómo formatear o convertir YAML
- 01
Pega tu YAML o JSON
Pega un manifiesto de Kubernetes, un flujo de trabajo de GitHub Actions, un archivo de valores Helm, o cualquier otro documento YAML. Para conversión de JSON a YAML, pega JSON en su lugar.
- 02
Elige una acción
Selecciona Formatear YAML para normalizar la indentación y limpiar el documento en su lugar. Selecciona YAML a JSON o JSON a YAML para convertir el formato completamente.
- 03
Revisa los errores si los hay
Si la entrada tiene un error de sintaxis, la herramienta muestra el número de línea exacto y la razón del analizador js-yaml — el mismo analizador que usa tu herramienta Node.js, por lo que el error coincide con lo que verías en producción.
- 04
Copia el resultado
Haz clic en Copiar para obtener el resultado formateado o convertido. Pégalo de vuelta en tu archivo de configuración, un cuerpo de API, o una definición de esquema.
Cuándo esta herramienta te ahorra tiempo
- 01El manifiesto de Kubernetes se ha desviado — normaliza la indentación antes de confirmar.
- 02El flujo de trabajo de GitHub Actions falla al analizar — valida para obtener la línea de error exacta.
- 03La API solo acepta JSON pero la configuración se almacena como YAML — convierte con un clic.
- 04Incorporar un nuevo servicio — convierte la carga útil de ejemplo JSON a YAML para el gráfico Helm.
- 05Copiar YAML de Stack Overflow — reformatea para que coincida con el estilo de 2 espacios de tu proyecto.
- 06Depuración de una fusión de valores Helm — valida que cada values.yaml sea individualmente limpio.
Privado, sin necesidad de subir
El formateo y la conversión se ejecutan completamente en tu navegador usando js-yaml — la misma librería incluida en Webpack, Rollup y la mayoría de herramientas de compilación de JavaScript. Tus archivos de configuración, referencias de secretos y nombres de variables de entorno nunca abandonan tu dispositivo.
El analizador se dirige a YAML 1.2, que es lo que Kubernetes, GitHub Actions, Docker Compose y Helm utilizan. Si un archivo se valida aquí, se cargará correctamente en esas herramientas.
Preguntas frecuentes del formateador YAML
¿Preservará el formateo YAML los comentarios?
No. El analizador js-yaml elimina comentarios durante el análisis — esta es una limitación de todos los analizadores YAML de JavaScript. Formatea primero, luego agrega comentarios de vuelta manualmente.
¿Qué versión de YAML es compatible?
YAML 1.2, que es la versión utilizada por Kubernetes, GitHub Actions, Docker Compose y Helm. Lo que se valida aquí se cargará correctamente en esas herramientas.
¿La conversión de YAML a JSON preserva los tipos?
Sí. Los números, booleanos, nulo y cadenas de fecha se convierten correctamente. Un true en YAML se convierte en un booleano true en JSON, no en la cadena 'true'.
¿Cuál es la diferencia entre formatear y convertir?
Formatear mantiene el archivo como YAML y normaliza espacios en blanco e indentación. Convertir cambia el formato de salida completamente — YAML a JSON produce un documento compatible con .json.
Mi YAML tiene múltiples documentos separados por ---. ¿Se procesarán todos?
El primer documento se analiza y se re-emite. Para archivos de múltiples documentos, divide cada sección en --- y procésalas individualmente.