¡Convierte YAML en JSON!

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

¡Convierte YAML en JSON!

Convierte un documento YAML (yml) en JSON para ver la estructura que oculta la indentación y el tipo real con el que se interpretó cada valor. Las anclas y los alias se expanden en valores reales, y varios documentos separados por --- se reúnen en un array.

Es especialmente útil para detectar errores clásicos de YAML: un valor que cuelga del padre equivocado por un espacio de menos, o un version: 1.10 que se convierte en silencio en el número 1.1.

Cómo usar

  1. Pega un docker-compose.yml, un manifiesto de Kubernetes o un archivo de workflow en el cuadro YAML, o arrastra el archivo sobre él.
  2. Los errores de sintaxis aparecen en el resultado con número de línea y columna; revisa primero la indentación en ese punto.
  3. Lee el JSON bajo Resultado para ver si cada valor quedó como cadena, número o booleano, y cópialo si lo necesitas.

Ejemplo

Entrada (YAML)
name: ci
on:
  push:
    branches: [main]
defaults: &node
  runs-on: ubuntu-latest
  timeout-minutes: 10
jobs:
  test: *node
Salida (JSON)
{
  "name": "ci",
  "on": {
    "push": {
      "branches": [
        "main"
      ]
    }
  },
  "defaults": {
    "runs-on": "ubuntu-latest",
    "timeout-minutes": 10
  },
  "jobs": {
    "test": {
      "runs-on": "ubuntu-latest",
      "timeout-minutes": 10
    }
  }
}

La clave on: de GitHub Actions se queda como la clave de texto "on", porque esta herramienta parsea con las reglas de YAML 1.2. El bloque definido con el ancla &node se expande en lugar de *node.

Funciones compatibles

  • Se parsea con el core schema de YAML 1.2: yes, on y off se quedan como cadenas, y solo true/True/false pasan a booleanos.
  • ~ y los valores vacíos pasan a null; el hexadecimal 0x1F y el octal 0o17 pasan a números.
  • Las &anchors y los *aliases se resuelven a los valores referenciados.
  • Los bloques escalares literales | y plegados > se convierten en cadenas aplicando las reglas de saltos de línea de YAML.
  • Varios documentos separados por --- se convierten en un array JSON; un solo documento se emite como su propio valor.
  • Una clave que aparece dos veces en el mismo mapping se reporta como error.

Casos de uso

Revisar la indentación de manifiestos de Kubernetes

Si el env bajo containers tiene un nivel menos de indentación, se engancha en silencio a otro campo y solo te enteras al aplicar. En JSON, las llaves muestran exactamente a qué objeto pertenece.

Usar la configuración desde el código

Para un script o un bundle de front-end en el que añadir un parser de YAML es excesivo, convierte la configuración una vez y úsala como import config from './config.json'.

Inspeccionar una especificación OpenAPI

Un documento OpenAPI escrito en YAML es más fácil de consultar con JSONPath o jq una vez convertido, por ejemplo para extraer el schema de una ruta concreta.

Notas y limitaciones

  • Se aplican las merge keys (<<: *defaults): se copian las claves del mapping anclado, y las claves escritas junto a << las sobrescriben. Un parser solo de YAML 1.2 mantendría << como una clave normal, así que los resultados pueden diferir de esas herramientas.
  • Las fechas y horas como 2024-01-01 se quedan como cadenas en lugar de convertirse en valores Date.
  • .inf y .nan no tienen representación en JSON y pasan a null.
  • Los comentarios no se pueden llevar a JSON y se descartan.
  • PyYAML (YAML 1.1) lee on y yes como true, así que los resultados desde Python pueden ser distintos.

Preguntas frecuentes

¿Por qué el on de GitHub Actions aparece como "on" en lugar de true?

En YAML 1.2 los únicos booleanos son true y false, así que on es una cadena normal, que es también como GitHub Actions lee esa clave. PyYAML de Python sigue la 1.1 y la convierte en una clave True, así que ten cuidado al parsear workflows desde scripts.

version: 1.10 sale como 1.1.

Sin comillas, 1.10 es un número en YAML, y 1.10 es igual a 1.1. Para mantener una cadena de versión, ponla entre comillas en el YAML de origen como "1.10".

¿Qué pasa con un archivo que contiene varios documentos?

Cada documento separado por --- se convierte en un elemento del array, en orden, así que un archivo con varios recursos usado con kubectl apply -f da un array de recursos.