Formateador de YAML
Formatea, valida y convierte documentos YAML con resaltado de sintaxis y detección de errores
Entrada YAML
Salida Formateada
Inspector de YAML
Opciones Avanzadas
Compara con otro YAML
Envía este documento a Data Diff y pega una segunda versión para ver qué cambió.
Validación con la posición exacta del error
La validación se ejecuta con cada pulsación de tecla usando el parser js-yaml 1.2. Los documentos válidos muestran conteos en vivo de documentos, mapeos, secuencias, claves y profundidad. Los que tienen errores reportan la línea y columna exactas, una causa probable y un resaltado en la posición que falla — no solo un "error de sintaxis".
Errores comunes de YAML que esta herramienta ubica con precisión
Estos errores explican la mayoría del YAML inválido. Cada uno se detecta con una posición y una causa probable:
Indentación incorrecta
Una línea hija indentada menos que su nivel superior, o líneas hermanas que no se alinean. Normalmente se reporta como "bad indentation of a mapping entry" en la línea exacta.
Carácter TAB
YAML prohíbe tabuladores en la indentación. El parser reporta "found a tab character that violates indentation" y resalta la línea problemática.
Clave duplicada
La misma clave dos veces en un mismo mapeo. js-yaml reporta "duplicated mapping key" con la línea de la segunda aparición.
Faltan dos puntos o un espacio
Una clave sin valor ("key key2") o dos puntos pegados a la clave ("key:value" es una cadena de texto plano, no un par). Se reporta como "could not find expected ':'".
Antes / Después
Manifiesto de Kubernetes minificado a la izquierda, el mismo documento formateado con indentación de 2 espacios a la derecha. La estructura, el árbol y las rutas se actualizan a partir del documento parseado.
{apiVersion: apps/v1, kind: Deployment, metadata: {name: web-app}, spec: {replicas: 3, template: {metadata: {labels: {app: web}}}}}apiVersion: apps/v1
kind: Deployment
metadata:
name: web-app
spec:
replicas: 3
template:
metadata:
labels:
app: webReferencia rápida de YAML (YAML 1.2)
- La indentación es estructura: solo espacios — los caracteres TAB nunca se permiten para indentar.
- Los dos puntos deben ir seguidos de un espacio para ser un separador de clave: "key: value", no "key:value".
- Los escalares se resuelven a tipos según el esquema core: true/false (booleanos), enteros, flotantes, null (~ / null / vacío). Ten en cuenta que "yes"/"no" son cadenas de texto plano en 1.2.
- Los documentos múltiples en un archivo se separan con una línea "---"; "..." termina un documento.
- Los anclajes (&base) y los alias (*base) mantienen los archivos DRY; las claves de fusión ("<<: *base") heredan mapeos.
Siguientes pasos con estos datos
Formatear es el primer paso. Continúa el flujo de trabajo sin salir de tu navegador:
Preguntas Frecuentes
Respuestas a preguntas comunes sobre el formateo de Yaml Formatter
El formateador sigue la especificación YAML 1.2, lo que garantiza compatibilidad con herramientas modernas como Kubernetes, Docker Compose, GitHub Actions y otras plataformas cloud-native.
Sí, la función de conversión bidireccional te permite convertir YAML a JSON y JSON a YAML conservando los tipos de datos, las estructuras anidadas y los comentarios cuando aplica.
Por supuesto. El formateador está diseñado para manejar manifiestos de Kubernetes, archivos de Docker Compose, pipelines de CI/CD y otros archivos YAML multi-documento con la separación correcta de secciones.
El validador revisa la consistencia de la indentación, el uso correcto de dos puntos y guiones, el balance de las cadenas entre comillas y las referencias de anclas y alias, y muestra mensajes de error con la línea específica para depurar rápido.
Sí, el formateador maneja correctamente las anclas (&), los alias (*) y las merge keys (<<) de YAML, conservando estas funciones DRY mientras formatea la estructura que las rodea.
YAML 1.2, la especificación actual de yaml.org - la versión a la que apuntan los documentos de Kubernetes, docker-compose y GitHub Actions. YAML 1.2 convirtió a JSON en un subconjunto válido y endureció el parseo de booleanos; el formateador mantiene tus comillas explícitas donde los parsers 1.1 (aún comunes en Python PyYAML) leerían mal valores como "no" o "0777".
Las anclas, los alias y los block scalars de YAML conservan los comentarios sin cambios, pero un comentario ligado a una clave que se reindenta se mueve con su nivel de indentación. El formateador nunca borra comentarios - solo los reubica mínimamente para que queden pegados al nodo que documentan.
Lo señala: NO, no, ON, on, yes y n sin comillas se entrecomillan automáticamente durante el formateo, así que los parsers de YAML 1.1 no pueden coercionarlos a booleanos. La lista de códigos de país [NO, SE, DK] se mantiene como tres cadenas. YAML 1.2 solo trata true/false como booleanos, pero entrecomillar es la única salida que es segura en ambas versiones.
Referencias autorizadas
Estándares y documentación oficial que definen los formatos con los que trabaja esta herramienta.
Herramientas esenciales para desarrolladores y programadores para formatear, validar y manipular código