Convertidor YAML ↔ JSON

YAML y JSON son los dos formatos de configuración dominantes en desarrollo moderno. A veces necesitás pasar de uno a otro: por ejemplo, convertir la configuración de un <code>docker-compose.yml</code> a JSON para un API endpoint, o transformar un <code>package.json</code> en YAML para documentación. Este convertidor maneja ambas direcciones al instante.

Diferencias clave entre YAML y JSON

En YAML, el string 'true' sin comillas se convierte a boolean true en la mayoría de parsers, lo que puede romper validaciones si el campo espera string. Siempre revisá los tipos al convertir.

JSON es un subconjunto estricto —solo llaves, corchetes, comillas dobles y valores primitivos—, lo que lo hace ideal para intercambio de datos en APIs y configuraciones de paquetes npm. YAML sacrifica la verbosidad por legibilidad humana: usa indentación en lugar de llaves, acepta comentarios con # y no requiere comillas en strings simples. Un .github/workflows/deploy.yml con 80 líneas sería significativamente más largo y menos legible en JSON.

La trampa más frecuente al convertir de YAML a JSON es que YAML infiere tipos: version: 3.8 se convierte en "version": 3.8 (número flotante), pero en Docker Compose ese valor debe ser string. El convertidor muestra el resultado para que puedas verificar que los tipos sean los correctos antes de usar el JSON en producción.

Herramientas que usan cada formato

YAML: GitHub Actions, GitLab CI, Kubernetes manifests, Docker Compose, Ansible playbooks, configuraciones de ESLint y Prettier, Helm charts. JSON: package.json, tsconfig.json, APIs REST, respuestas de webhooks, configuración de VS Code (settings.json), esquemas JSON Schema. Algunos proyectos aceptan ambos formatos —como Prettier o Jest— y la elección es de preferencia del equipo.

Un caso concreto: si recibís la configuración de un microservicio en YAML de un colega DevOps y necesitás enviarla como body de un API POST, este convertidor te da el JSON válido en segundos sin tener que buscar una librería o escribir un script de Node.

Limitaciones del parser client-side

El parser soporta los tipos más comunes: strings, números enteros y flotantes, booleanos, null, listas y objetos anidados de cualquier profundidad. Las funcionalidades avanzadas de YAML —anclas (&anchor), referencias (*alias), bloques de texto multi-línea (| y >) y tags de tipo (!!str)— requieren un parser server-side más robusto como js-yaml completo.

Para YAML con caracteres especiales en strings (dos puntos, guiones al inicio de línea), el convertidor aplica las reglas de escape automáticamente en la salida JSON. Si encontrás un error de parseo, verificá que la indentación sea consistente: YAML no acepta mezcla de tabs y espacios.