JSON vs YAML
JSON y YAML representan los mismos datos —objetos, listas, valores— pero con prioridades distintas: JSON prioriza que las máquinas lo parseen rápido y sin ambigüedad; YAML prioriza que las personas lo lean y editen. Por eso JSON domina en APIs y YAML en archivos de configuración.
| Aspecto | JSON | YAML |
|---|---|---|
| Legibilidad humana | Media (llaves y comillas) | Alta (indentación limpia) |
| Comentarios | No soporta | Sí (#) |
| Velocidad de parseo | Muy rápida | Más lenta |
| Riesgo de error | Bajo | Alto (indentación) |
| Uso típico | APIs, almacenamiento | Configuración, CI/CD |
Cuándo usar JSON
Usá JSON para respuestas de API, intercambio entre servicios, almacenamiento y cualquier caso donde lo consuma un programa. Es más estricto, más rápido de parsear y no depende de la indentación.
Cuándo usar YAML
Usá YAML para configuración que edita una persona (CI, Docker Compose, Kubernetes): comentarios, menos llaves y comillas, y anclas para reutilizar bloques. A cambio, la indentación es significativa y un espacio de más rompe el archivo.
En resumen: No es "uno mejor que otro": JSON para máquinas, YAML para humanos. Como YAML es un superset de JSON, casi siempre podés convertir de uno a otro sin perder datos.