Formatea, indenta y valida YAML con detección de errores por línea
Pega YAML arriba para formatearlo con indentación consistente
También podrías necesitar
YAML (Yet Another Markup Language) es el estándar de configuración legible por humanos usado en Docker Compose, Kubernetes, GitHub Actions, Ansible, Circleci, GitLab CI, Prometheus y una gran cantidad de sistemas de infraestructura moderna. Un archivo YAML mal indentado o con caracteres sospechosos puede producir errores silenciosos que se descubren solo en producción — un espacio extra o una tabulación pueden invalidar todo un pipeline. Esta herramienta usa js-yaml (la librería de referencia del ecosistema JavaScript, con más de 60 millones de descargas semanales) para hacer un parse estricto de tu YAML y volverlo a serializar con indentación consistente. Si el YAML tiene errores de sintaxis — claves duplicadas, aliases no resueltos, comillas mal cerradas, escape inválido — la herramienta muestra el mensaje exacto del parser junto con la línea y columna precisas del error. Los tipos implícitos de YAML 1.2 (booleanos, enteros, floats, fechas ISO 8601, null) se preservan durante el formateo. El procesamiento ocurre completamente en tu navegador; ningún archivo YAML sale de tu dispositivo, lo cual es crítico cuando trabajas con secrets accidentales, hostnames internos o credenciales en configuraciones.
¿Cuál es la diferencia entre validar y formatear YAML?
Validar comprueba que la sintaxis sea correcta según la especificación YAML 1.2: indentación consistente, comillas cerradas, claves no duplicadas dentro de un mapa, aliases resueltos. Formatear va un paso más allá: además de validar, re-serializa el documento con indentación uniforme y estilo consistente. Esta herramienta hace ambas cosas — si el YAML es válido, produce una versión formateada; si no lo es, muestra el error exacto con línea y columna.
¿Los comentarios se preservan al formatear?
No. Los parsers de YAML como js-yaml descartan los comentarios durante el parsing porque no forman parte del árbol semántico. Al re-serializar, no hay forma de reinsertarlos en su posición original. Si tu YAML tiene comentarios importantes (# esta línea explica X), considera preservarlos manualmente después de formatear, o usar herramientas de línea de comandos como yq que sí preservan comentarios con la opción -P.
¿Qué pasa con las etiquetas de tipo (!!str, !!int, !!binary)?
Las etiquetas de tipo explícitas (!!str, !!int, !!float, !!binary, !!timestamp) son procesadas por js-yaml según su tipo declarado. Al formatear, las etiquetas se preservan solo si son necesarias para desambiguar el tipo — por ejemplo, si escribes '123' como string explícito con !!str "123", el formateador puede convertirlo a la forma con comillas dobles para lograr el mismo efecto de forma más idiomática.
¿Detecta claves duplicadas?
Sí. La especificación YAML 1.2 prohíbe claves duplicadas en el mismo mapa. Si tu YAML tiene, por ejemplo, dos entradas 'name:' en la misma sección, el parser lanza un error con la línea del duplicado. Este es un error común al copiar y pegar bloques de configuración, especialmente en Docker Compose o Kubernetes.
¿Puedo usar esta herramienta para YAML con múltiples documentos (---)?
Esta herramienta procesa un único documento YAML por invocación. El separador --- al inicio es reconocido y se considera el comienzo del primer documento. Si tu archivo tiene múltiples documentos separados por ---, formatéalos individualmente y luego combínalos. Para archivos de Kubernetes con múltiples recursos, esta división manual es la práctica recomendada por herramientas como kustomize.