YAML Formatter
NuevoValidate, beautify, and convert YAML online. Real-time syntax highlighting, error detection with line numbers, and one-click JSON export.
Input
Formatted output
← paste YAML to see formatted outputRuns entirely in your browser. Nothing is uploaded.
Formatea y valida YAML al instante en tu navegador
El formateador YAML valida y embellece tu YAML en tiempo real mientras escribes o pegas — sin necesidad de pulsar ningún botón. Normaliza la indentación, resalta los errores de sintaxis con números de línea y explicaciones, y proporciona conversión a JSON con un solo clic. El editor tiene resaltado de sintaxis completo usando propiedades CSS personalizadas que se adaptan a la preferencia de modo oscuro o claro del sistema. Todo funciona en el lado del cliente usando un parser YAML en JavaScript — tus archivos de configuración nunca salen de tu dispositivo.
YAML (YAML Ain't Markup Language) se usa en casi todos los proyectos de software modernos: flujos de trabajo de GitHub Actions, manifiestos de Kubernetes, archivos Docker Compose, playbooks de Ansible, charts de Helm, configuraciones de CI/CD y archivos de configuración de aplicaciones. Es legible por humanos por diseño, pero su sensibilidad a la indentación y los caracteres especiales hacen que sea sorprendentemente fácil escribir YAML inválido que solo falla en tiempo de ejecución — cuando ya es demasiado tarde. Un formateador en vivo detecta esos errores en segundos.
Errores comunes de YAML y cómo los detecta el validador
El error de YAML más común es usar tabulaciones en vez de espacios. YAML prohíbe los caracteres de tabulación en la indentación — se ven idénticos a los espacios en la mayoría de los editores de texto pero causan fallos de análisis inmediatos. El validador detecta esto y te indica exactamente qué línea tiene la tabulación. El segundo error más común son los dos puntos sin comillas en los valores: `title: Hello: World` es ambiguo — el parser ve una clave anidada. Pon el valor entre comillas: `title: "Hello: World"`. El tercero es la indentación inconsistente: si un bloque está indentado con 2 espacios en un lugar y con 3 en otro, el parser puede malinterpretar el nivel de anidamiento.
Otros errores comunes: claves duplicadas en el mismo mapeado (técnicamente permitido en YAML 1.1 pero ilegal en 1.2, y rechazado por la mayoría de los parsers); falta de espacio después de los dos puntos (`clave:valor` es inválido, necesita `clave: valor`); anclas y alias usados incorrectamente; y sorpresas de coerción implícita de tipos (la cadena `yes` se convierte en booleano `true` en los parsers de YAML 1.1). El validador informa cada uno de estos con lenguaje claro, no solo un volcado de error del parser.
Conversión de YAML a JSON — cuándo y por qué
JSON y YAML son formatos de datos semánticamente equivalentes (con algunas excepciones). YAML es un superconjunto de JSON — el JSON válido también es YAML válido. Convertir YAML a JSON es útil cuando se trabaja con herramientas o APIs que solo aceptan JSON, o cuando quieres usar `jq` para consultar un archivo de configuración YAML (jq opera sobre JSON). El botón "Copiar como JSON" parsea tu YAML y lo serializa a JSON formateado con indentación de 2 espacios.
Una nota importante: los comentarios de YAML (líneas que comienzan con `#`) no se preservan en la salida JSON porque JSON no tiene sintaxis de comentarios. Las anclas y alias de YAML se resuelven — el JSON muestra los valores finales desreferenciados. El YAML multi-documento (múltiples documentos separados por `---`) se convierte en un array JSON que contiene cada documento como un elemento. Si necesitas la operación inversa (JSON a YAML), pega el JSON en este formateador — dado que JSON es YAML válido, lo analizará y reformateará limpiamente.
Formateador YAML vs yamllint, YAML Lint y YAML Checker
yamllint es la herramienta CLI estándar para el linting de YAML — exhaustiva, configurable y usada en pipelines de CI. Pero requiere Python, pip y una terminal, lo que lo hace inaccesible para verificaciones rápidas en la máquina de un compañero de equipo o en un entorno de navegador. YAML Lint (yamllint.com) es la alternativa en línea más popular pero solo muestra errores — sin formateo, sin resaltado de sintaxis, sin conversión a JSON. YAML Checker (yamlchecker.com) formatea y valida pero tiene un textarea simple sin resaltado y sin salida JSON. Transform.tools hace conversión YAML a JSON pero sin validación en vivo.
Este formateador combina todas esas capacidades en un solo lugar: validación en vivo con explicaciones de errores, salida formateada con resaltado de sintaxis, conversión a JSON con un clic y soporte multi-documento — funcionando completamente en tu navegador sin backend. Es el camino más rápido desde "¿es válido este YAML?" hasta "aquí está la versión formateada y sin errores" para los desarrolladores que prefieren no instalar herramientas ni registrarse en servicios.
Usos prácticos — Kubernetes, GitHub Actions, Docker Compose
Para usuarios de Kubernetes: pega tu manifiesto antes de aplicarlo con `kubectl apply` para detectar errores de sintaxis temprano. Un solo error de indentación en una especificación de Pod o una definición de Service hará que `kubectl` falle con un error críptico; detectarlo aquí primero ahorra tiempo. Para usuarios de GitHub Actions: pega tu archivo `.github/workflows/*.yml` para validarlo antes de hacer commit. Los flujos de trabajo malformados fallan silenciosamente (la acción simplemente no se ejecuta) y depurarlos en la interfaz de GitHub es lento. Para usuarios de Docker Compose: valida tu `docker-compose.yml` antes de ejecutar `docker compose up` — especialmente importante para archivos multi-servicio donde un error de definición de servicio anidado puede ser difícil de detectar.
Para usuarios de Ansible: pega playbooks, archivos de inventario o archivos de variables para validar la estructura YAML antes de ejecutar `ansible-playbook`. Para autores de charts de Helm: valida tu `values.yaml` o las plantillas del chart. Para cualquiera que escriba configuración de CI/CD en YAML (GitLab CI, CircleCI, Bitbucket Pipelines, Travis CI): pega la configuración y valida antes de hacer push. En todos estos casos, el coste de un archivo YAML inválido es una compilación o despliegue fallido — detectarlo aquí primero siempre es más rápido.
Frequently asked questions
¿Cómo formateo YAML en línea?
Pega tu YAML en el editor de la izquierda y se formatea y valida automáticamente en tiempo real a la derecha. El formateador normaliza la indentación a 2 espacios, elimina los espacios en blanco al final y muestra tu YAML con resaltado de sintaxis. Si hay errores de sintaxis, se resaltan en línea con una explicación de qué está mal y en qué línea está el problema. No hay botón que pulsar — el formateo ocurre mientras escribes o pegas.
¿Cómo valido YAML para detectar errores de sintaxis?
Pega tu YAML y el validador lo analiza inmediatamente usando un parser YAML del lado del cliente. Si el YAML es inválido, verás un banner de error en rojo con el mensaje de error específico y el número de línea — el mismo tipo de error que lanzaría un pipeline de CI/CD (como GitHub Actions o Kubernetes). Los errores comunes de YAML incluyen indentación incorrecta (tabulaciones en vez de espacios — YAML requiere espacios), falta de dos puntos después de las claves, claves duplicadas, o caracteres especiales sin comillas como dos puntos en valores.
¿Puedo convertir YAML a JSON?
Sí — hay un botón "Copiar como JSON" que parsea tu YAML y genera el JSON equivalente, formateado y listo para usar. Es útil cuando tienes un archivo de configuración YAML (como un flujo de trabajo de GitHub Actions o un manifiesto de Kubernetes) y necesitas los mismos datos en formato JSON para una API, un script o una herramienta que solo acepta JSON. La conversión no tiene pérdida para YAML estándar — los comentarios no se preservan en JSON ya que JSON no tiene sintaxis de comentarios.
¿Por qué necesita YAML un formateador?
YAML es sensible a la indentación: un espacio extra o un carácter de tabulación donde se esperaba un espacio romperá el análisis. Esto hace que editar YAML a mano sea propenso a errores, especialmente en configuraciones profundamente anidadas como manifiestos de Kubernetes, archivos Docker Compose, flujos de trabajo de GitHub Actions y playbooks de Ansible. Un formateador aplica indentación consistente (2 o 4 espacios, a tu elección), normaliza los espacios en blanco al final y detecta errores de sintaxis antes de que lleguen a un pipeline de CI/CD o despliegue.
¿Funciona en iPhone y Android?
Sí. El editor es responsive y funciona en Safari en iPhone y Chrome en Android. Pegar YAML desde el portapapeles funciona en móvil, y la salida formateada y los mensajes de error se muestran claramente en pantallas pequeñas. Dado que todo es del lado del cliente, el formateo es instantáneo sin viaje al servidor que introduzca latencia en conexiones móviles más lentas.
¿Necesito registrarme o pagar?
No. El formateador YAML es completamente gratuito, sin necesidad de cuenta y sin límites de uso. Puedes formatear, validar y convertir todo el YAML que quieras. Siempre será gratuito.
¿Es privado mi YAML?
Sí — todo funciona en tu navegador. Tu código YAML nunca se envía a ningún servidor, nunca se almacena y nunca se registra. Esto es especialmente importante para los archivos YAML que pueden contener secretos de configuración, claves de API o credenciales de base de datos. A diferencia de las herramientas YAML basadas en web que envían tu contenido a un backend para procesarlo, este formateador analiza y formatea completamente en tu navegador usando JavaScript.
Related tools
Ver todas las herramientas
Nuevo Comparador de diferencias
Compara dos textos y resalta cada diferencia, en paralelo o en línea.
Nuevo Codificar / Decodificar URL
Codifica o decodifica texto en porcentaje y analiza cadenas de consulta, todo en tu navegador.
Nuevo Codificar / Decodificar entidades HTML
Convierte y revierte entidades HTML, con codificación numérica opcional.
Nuevo Constructor de expresiones Cron
Explica una programación cron en lenguaje claro y previsualiza sus próximas ejecuciones.
Nuevo Minificador de HTML
Comprime HTML eliminando comentarios y colapsando los espacios en blanco.
Nuevo Minificador de CSS
Reduce el CSS quitando comentarios y los espacios en blanco innecesarios.