YAML vs JSON: diferencias y cuándo usar cada formato

YAML y JSON representan datos estructurados y comparten el mismo modelo subyacente: objetos y arrays. Pero fueron diseñados para audiencias distintas. JSON se creó para las máquinas; YAML se creó para los humanos que mantienen archivos de configuración cada día.

Sintaxis de un vistazo

Los mismos datos escritos en ambos formatos:

# YAML
nombre: Alicia
edad: 30
activo: true
puntuaciones:
  - 95
  - 87

// JSON
{
  "nombre": "Alicia",
  "edad": 30,
  "activo": true,
  "puntuaciones": [95, 87]
}

Diferencias clave

• Sintaxis: YAML usa indentación para definir la estructura; JSON usa llaves, corchetes, comas y comillas explícitas.
• Comentarios: YAML admite comentarios en línea con #; JSON no admite comentarios.
• Verbosidad: YAML es más conciso y legible para humanos que editan archivos directamente.
• Estricto vs. flexible: JSON tiene una sintaxis sin ambigüedades. YAML admite varias formas válidas de escribir el mismo valor, lo que puede generar errores sutiles.
• Seguridad en el análisis: los parsers de JSON son simples y universales. Los de YAML son más complejos y han tenido históricamente más vulnerabilidades (por ejemplo, ejecución de código arbitrario en parsers YAML antiguos de Ruby).

Cuándo usar JSON

• Respuestas y cuerpos de peticiones de API — JSON es el lenguaje universal de las APIs HTTP.
• Almacenamiento en el navegador — localStorage, IndexedDB y los payloads de fetch usan JSON de forma nativa.
• Archivos de configuración consumidos por código JavaScript o TypeScript.
• Cuando se necesita un análisis estricto y sin ambigüedades y no se espera edición manual.

Cuándo usar YAML

• Configuración de CI/CD — GitHub Actions, GitLab CI, CircleCI y la mayoría de herramientas de pipeline usan YAML.
• Infraestructura como código — manifiestos de Kubernetes, Docker Compose, playbooks de Ansible.
• Archivos de configuración de aplicaciones que los desarrolladores editan a mano — los comentarios ayudan a explicar la intención.
• Charts de Helm y sistemas de plantillas similares.

Cómo convertir entre YAML y JSON

1. Abre el conversor YAML a JSON o JSON a YAML.
2. Pega el documento de origen.
3. Haz clic en Convertir.
4. Revisa el resultado — comprueba que los tipos de cadena se han preservado correctamente.
5. Copia y usa el resultado.