Formateador y Validador de YAML
Formatea, valida y embellece tu YAML en línea. Resalta al instante los errores de sintaxis con números de línea. Gratuito y ejecutado completamente en tu navegador.
Cómo Usar
- Pega tu YAML en el área de entrada
- Haz clic en «Formatear y Validar» para embellecer y verificar la sintaxis
- Si el YAML no es válido, un mensaje de error mostrará la línea exacta y el problema
- Ajusta el selector de sangría para controlar la indentación de salida
- Haz clic en «Copiar» para copiar el resultado formateado, o en «Limpiar» para restablecer
Preguntas Frecuentes
-
¿Qué es la validación de YAML?
La validación de YAML comprueba que el documento sigue la sintaxis YAML correcta: indentación adecuada, sin claves duplicadas, tipos de datos válidos y uso correcto de caracteres especiales.
-
¿El formateo cambia mis datos?
No. El formateo solo cambia los espacios en blanco y la indentación. La estructura de datos y los valores permanecen exactamente iguales.
-
¿Cuáles son los errores de sintaxis YAML más comunes?
Los errores más comunes incluyen indentación inconsistente (mezcla de tabulaciones y espacios), falta de dos puntos después de las claves, cadenas sin comillas que contienen caracteres especiales como : o #, y claves duplicadas.
-
¿Mi YAML se envía a un servidor?
No. Todo el formateo y la validación ocurre completamente en tu navegador usando la librería js-yaml. Tus datos nunca salen de tu dispositivo.
-
¿Cuál es la diferencia entre YAML y JSON?
YAML es un superconjunto de JSON que admite comentarios, cadenas multilínea y es menos verboso. JSON usa llaves y comillas, mientras que YAML usa indentación. YAML se usa habitualmente en archivos de configuración, JSON en APIs.
Qué es YAML y por qué se usa tanto
YAML (acrónimo recursivo de "YAML Ain't Markup Language") es un formato de serialización de datos diseñado para ser legible por humanos. A diferencia de JSON o XML, YAML usa la indentación para expresar la estructura jerárquica, lo que lo hace visualmente limpio y fácil de editar a mano. Esto lo convirtió en el formato preferido para archivos de configuración en el ecosistema DevOps: Docker Compose, Kubernetes, GitHub Actions, Ansible, CircleCI y muchas otras herramientas lo usan de forma nativa.
La sintaxis de YAML en detalle
YAML tiene tres tipos básicos de estructuras de datos:
Mapas (objetos clave-valor)
nombre: María García
edad: 32
activo: true
Secuencias (listas)
lenguajes:
- Python
- JavaScript
- Go
Escalares (valores simples)
Los valores pueden ser cadenas, números enteros, números decimales, booleanos (true/false) o nulos (null). Las cadenas no necesitan comillas a menos que contengan caracteres especiales.
Características que YAML tiene y JSON no
- Comentarios: YAML admite comentarios con
#. Esto es fundamental en archivos de configuración donde documentar las opciones es esencial. - Cadenas multilínea: con
|(bloque literal, preserva saltos de línea) o>(bloque plegado, convierte saltos de línea en espacios). - Anclas y alias: permiten reutilizar partes del documento sin repetir código.
- Tipos de datos extendidos: YAML puede representar tipos que JSON no tiene, como fechas.
Errores de sintaxis más comunes
Mezcla de tabulaciones y espacios
YAML no permite tabulaciones para la indentación. Solo espacios. Este es el error más frecuente cuando se edita YAML en editores que convierten espacios a tabulaciones automáticamente.
Valores con caracteres especiales sin comillas
# Incorrecto:
mensaje: Hello: World
descripcion: precio #final
# Correcto:
mensaje: "Hello: World"
descripcion: "precio #final"
Los dos puntos (:) seguidos de un espacio y el símbolo almohadilla (#) tienen significado especial en YAML. Si aparecen en un valor, el valor debe ir entre comillas.
Indentación inconsistente
Todos los elementos de un mismo nivel deben tener exactamente la misma indentación. Si mezclas 2 espacios y 4 espacios en el mismo archivo, el parser fallará.
Comparación con JSON
| Característica | YAML | JSON |
|---|---|---|
| Comentarios | Sí (#) |
No |
| Comillas en claves | Opcionales | Obligatorias |
| Tipos de datos | Más ricos | Limitados |
| Verbosidad | Baja | Media |
| Parsing | Más complejo | Simple y rápido |
| Uso principal | Configuración | APIs e intercambio |