¡Convierte JSON en YAML!

¡Introduce JSON para convertirlo en YAML legible! Compatible con yml, Kubernetes, docker-compose, Spring application.yml.
JSON
Resultado
 

¡Convierte JSON en YAML!

Convierte JSON en YAML basado en indentación. Desaparecen las llaves y la mayoría de las comillas, lo que hace que el resultado sea más fácil de mantener a mano como archivo de configuración, y el orden de las claves se mantiene exactamente como en el JSON de origen.

Te sirve cuando pasas a un manifiesto un recurso obtenido con kubectl get -o json, o cuando pegas en docker-compose.yml, application.yml o un workflow de GitHub Actions una configuración recibida de una API.

Cómo usar

  1. Pega JSON en el cuadro JSON. Si la sintaxis no es válida, el resultado muestra JSON parsing failed; pásalo antes por el validador de JSON si hace falta.
  2. Revisa el YAML bajo Resultado. La indentación es de dos espacios.
  3. Cópialo en tu archivo .yml, ajustando la profundidad de indentación si lo anidas bajo otro bloque.

Ejemplo

Entrada (JSON)
{
  "services": {
    "web": {
      "image": "nginx:1.27",
      "ports": ["8080:80"],
      "environment": { "FEATURE_FLAG": "on", "GREETING": "hello\nworld" }
    }
  }
}
Salida (YAML)
services:
  web:
    image: nginx:1.27
    ports:
      - 8080:80
    environment:
      FEATURE_FLAG: "on"
      GREETING: |-
        hello
        world

La cadena "on" conserva sus comillas: escrita sin ellas como on, un parser de YAML 1.1 la leería como el booleano true. GREETING contiene un salto de línea, así que se emite como un bloque |- que muestra cada línea tal como está escrita.

Funciones compatibles

  • Las comillas siguen YAML 1.1. Cadenas como yes, no, on, off, y, n, ~, null, y otras que lo parecen como "0777", "1.0" o "2024-01-01", van entre comillas para que PyYAML (1.1) y los parsers modernos de 1.2 lean el mismo valor.
  • Las cadenas como 22:22, que YAML 1.1 puede leer como número en base 60, también van entre comillas, lo que evita un bug clásico en el mapeo de puertos de docker-compose.
  • Las cadenas de varias líneas pasan a ser bloques literales |-.
  • Las cadenas largas nunca se pliegan (no hay límite de ancho de línea).
  • Los arrays y objetos vacíos se quedan como [] y {}.

Casos de uso

De la salida JSON de kubectl a un manifiesto

Convierte un Deployment o un ConfigMap sacado del clúster como JSON, borra campos como status y metadata.uid, y tienes un manifiesto listo para Git.

Escribir el application.yml de Spring Boot

Un bloque de propiedades recibido como JSON desde un config server o la documentación se convierte en una jerarquía YAML, así que no tienes que indentar a mano claves como spring.datasource.url.

Notas y limitaciones

  • No se generan comentarios, anclas (&) ni alias (*); un objeto repetido en el JSON se repite en el YAML.
  • Los enteros mayores que 9007199254740991 pierden precisión por el límite numérico de JavaScript; mantén los IDs largos como cadenas en el JSON.
  • La salida es un solo documento. Para un archivo con varios recursos separados por ---, convierte cada recurso y únelos tú mismo.

Preguntas frecuentes

¿Por qué algunas cadenas van entre comillas y otras no?

Las comillas se añaden solo donde un valor sin comillas se leería como otro tipo. nginx:1.27 es una cadena en cualquier caso, pero on, 010 y 22:22 se convierten en booleanos o números en algunos parsers, así que van entre comillas.

¿Puedo aplicar la salida directamente en Kubernetes?

La estructura es válida tal cual. Aun así, la salida de kubectl get -o json trae campos rellenados por el servidor como status, resourceVersion y managedFields, y conviene quitarlos antes de aplicar.

¿Puedo cambiar a indentación de cuatro espacios?

No hay opción; está fijada en dos espacios, la convención usada en toda la documentación de Kubernetes, docker-compose y GitHub Actions.