Convertir entre JSON y YAML

Esta herramienta transforma un documento YAML en JSON y a la inversa, preservando la estructura de los datos (objetos, tablas, tipos escalares). La conversión JSON a YAML, o YAML a JSON, es una operación habitual en desarrollo: se genera un fichero OpenAPI YAML a partir de una spec JSON, se convierte la salida de una API REST a YAML para confirmarla en un repositorio de configuración, se traduce un manifest Kubernetes YAML a JSON para pasarlo a kubectl --dry-run=client -o json, o se alinea un workflow GitHub Actions con un esquema JSON. En sentido amplio, es el puente entre el mundo del intercambio de datos (JSON) y el de la configuración editable a mano (YAML).

JSON y YAML abordan necesidades cercanas pero casos de uso distintos. La tabla siguiente resume las diferencias técnicas principales, útiles para elegir entre ambos según el contexto.

JSON se impone en cuanto un programa habla con otro programa. Sus casos de uso típicos:

• APIs REST y GraphQL: payloads de petición y de respuesta.
• Intercambio de datos entre microservicios y colas de mensajes.
• Código JavaScript nativo: JSON.parse y JSON.stringify sin dependencia.
• Almacenamiento del lado del navegador: localStorage, sessionStorage, IndexedDB.
• Peticiones AJAX y fetch.
• Variantes binarias u orientadas a flujo: BSON (MongoDB), JSON Lines (logs, datasets ML), MessagePack.
• Configuración de herramientas JS / TS: package.json, tsconfig.json, composer.json.

YAML se impone en cuanto un humano edita el fichero con regularidad. Sus casos de uso típicos:

• Docker Compose (docker-compose.yml) y perfiles de stack.
• Manifests de Kubernetes (Deployment, Service, Ingress, Helm charts).
• Playbooks de Ansible e inventarios.
• Pipelines CI/CD: GitHub Actions, GitLab CI, CircleCI, Bitbucket Pipelines.
• Especificaciones OpenAPI / Swagger y AsyncAPI.
• Configuración aplicativa anotada (Symfony, Spring Boot, Rails) donde los comentarios son útiles.
• Ficheros editados con frecuencia a mano, donde la concisión y la legibilidad priman sobre la velocidad de parsing.

YAML es más permisivo que JSON, lo que lo convierte en un formato potente pero traicionero. Los errores más frecuentes:

• Indentación: las tabulaciones están prohibidas por la especificación, solo los espacios son válidos. Mezclar ambos o cambiar el número de espacios en un mismo bloque rompe el parsing.
• Coerción automática de los escalares: yes, no, on, off, true, false, null, None, ~ se parsean como booleanos o como null. Ejemplo trampa: un código postal 01234 sin entrecomillar se convierte en el entero 1234, y un nombre de país NO (Noruega) se convierte en false. Entrecomille siempre las cadenas ambiguas.
• Strings multilínea: | (block literal) conserva los saltos de línea tal cual, mientras que > (folded) sustituye los saltos de línea por espacios. Los indicadores de chomping - y + ajustan el comportamiento sobre el salto final.
• YAML 1.1 vs 1.2: la 1.1 (todavía muy extendida, por ejemplo mediante PyYAML por defecto) trata yes/no/on/off como booleanos, lo que la 1.2 ha eliminado. Los comportamientos también difieren en los números en base 8.
• Fechas implícitas: 2024-01-15 sin comillas es interpretado como un objeto fecha por algunos parsers, no como una cadena.

El mismo documento, expresado en JSON y, después, en YAML. Configuración sencilla de una aplicación con sus dependencias y su entorno:

Versión JSON

{
    "name": "cdrn-app",
    "version": "1.14.2",
    "environment": "production",
    "dependencies": {
        "php": "^8.3",
        "symfony/framework-bundle": "^7.0",
        "doctrine/orm": "^3.0"
    },
    "features": ["cache", "mailer", "queue"],
    "debug": false
}

Versión YAML equivalente

# Configuration de l'application
name: cdrn-app
version: 1.14.2
environment: production
dependencies:
    php: '^8.3'
    symfony/framework-bundle: '^7.0'
    doctrine/orm: '^3.0'
features:
    - cache
    - mailer
    - queue
debug: false

La versión YAML es aproximadamente un 25 % más corta en caracteres, admite un comentario al inicio y se lee como una lista de propiedades sin ruido sintáctico.

Pasos para convertir sus datos:

1. Pegue su documento fuente (JSON o YAML) en el campo de entrada.
2. Seleccione el sentido de conversión deseado (JSON a YAML, o YAML a JSON).
3. Haga clic en el botón de conversión: el resultado formateado aparece en la zona de salida.
4. Compruebe el resultado y, después, utilice el botón de copia para recuperarlo en su portapapeles.

La conversión se realiza localmente en su navegador o a través de una ruta de servidor dedicada según el tooling: ningún dato sensible se conserva.