Formateador 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
Comparar 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 en cada pulsación de tecla mediante el parser js-yaml 1.2. Los documentos válidos muestran en tiempo real el recuento de documentos, mapeos, secuencias, claves y profundidad. Los que tienen errores informan la línea y columna exactas, una causa probable y un resaltado en la posición del fallo — no solo un "error de sintaxis".
Errores comunes de YAML que esta herramienta detecta con precisión
Estos errores son responsables de 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 padre, o líneas hermanas que no se alinean. Normalmente se informa como "bad indentation of a mapping entry" en la línea exacta.
Carácter TAB
YAML prohíbe tabulaciones en la indentación. El parser informa "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 informa "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 unos dos puntos pegados a la clave ("key:value" es una cadena de texto plana, no un par). Se informa 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.
- Unos 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 planas en 1.2.
- Varios documentos en un mismo archivo se separan con una línea "---"; "..." termina un documento.
- Las anclas (&base) y los alias (*base) mantienen los archivos DRY; las claves de fusión ("<<: *base") heredan mapeos.
Siguientes pasos con estos datos
El formateo 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 la 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 es aplicable.
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 comprueba la consistencia de la indentación, el uso correcto de los dos puntos y los guiones, el equilibrio de las cadenas entre comillas, las referencias de anclas y alias, y ofrece mensajes de error con línea específica para depurar rápidamente.
Sí, el formateador maneja correctamente las anclas (&), los alias (*) y las claves de fusión (<<) de YAML, conservando estas características DRY mientras formatea la estructura circundante.
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 hizo de JSON un subconjunto válido e hizo más estricto el análisis de booleanos; el formateador mantiene tus comillas explícitas donde los parsers 1.1 (todavía comunes en Python PyYAML) interpretarían mal valores como "no" o "0777".
Las anclas, los alias y los escalares de bloque de YAML mantienen los comentarios sin cambios, pero un comentario adjunto a una clave que se reindenta se mueve con su nivel de indentación. El formateador nunca elimina comentarios - los reubica de forma mínima para que sigan unidos al nodo que documentan.
Lo marca: los valores sin comillas NO, no, ON, on, yes, n se entrecomillan automáticamente durante el formateo, de modo que los parsers de YAML 1.1 no pueden convertirlos en booleanos. La lista de códigos de país [NO, SE, DK] sigue siendo tres cadenas. YAML 1.2 solo trata true/false como booleanos, pero entrecomillar es la única salida segura bajo ambas versiones.
Referencias autorizadas
Estándares y documentación oficial que definen los formatos con los que trabaja esta herramienta.
Herramientas Relacionadas
Formateador JSON
Formatea, valida y embellece datos JSON con sangría inteligente y resaltado de sintaxis
Reparación de JSON
Corrige JSON malformado, inválido o roto al instante. Repara salidas de LLM truncadas, comas faltantes, claves sin comillas y comas finales en tu navegador
Formateador JSONL
Formatea archivos JSON Lines (NDJSON) y convierte entre JSON y JSONL. Valida cada línea y aplica formato con sangría a flujos NDJSON