JSON a YAML de GitHub Actions

Convierte una definición de flujo de trabajo en JSON en un archivo .github/workflows limpio, listo para hacer commit.

Opciones de salida

JSONentrada

Vacío

YAMLsalida

La salida YAML aparece aquí

Se ejecuta íntegramente en tu navegador: no se sube nada. Se aplican límites de uso razonable (5 MB por entrada, conversiones con límite de frecuencia) para evitar el spam y los bots.

Cargar desde URL

Tu navegador obtiene el archivo directamente, por lo que el servidor debe permitir solicitudes de origen cruzado.

Atajos de teclado

Ctrl / ⌘ + Enter Convertir ahora
Ctrl / ⌘ + S Descargar la salida
Alt + Shift + C Copiar la salida
Alt + Shift + F Reparar y formatear el JSON de entrada
Alt + Shift + S Invertir la dirección
Alt + Shift + T Alternar entre las vistas de código, árbol y mapa
Ctrl / ⌘ + Z Deshacer, incluidos Formatear, Reparar y Borrar
Esc Salir de pantalla completa
Tamaño del texto del editor

Un flujo de trabajo, de JSON a YAML

Los disparadores, los valores de la matriz, las expresiones y los scripts multilínea salen tal como los escribirías a mano.

workflow.json
{
  "name": "CI",
  "on": {
    "push": {
      "branches": [
        "main"
      ]
    }
  },
  "jobs": {
    "test": {
      "runs-on": "ubuntu-latest",
      "strategy": {
        "matrix": {
          "node": [
            "20",
            "22"
          ]
        }
      },
      "steps": [
        {
          "uses": "actions/checkout@v4"
        },
        {
          "uses": "actions/setup-node@v4",
          "with": {
            "node-version": "${{ matrix.node }}"
          }
        },
        {
          "run": "npm ci\nnpm test\n"
        }
      ]
    }
  }
}
.github/workflows/ci.yml
name: CI
'on':
  push:
    branches:
      - main
jobs:
  test:
    runs-on: ubuntu-latest
    strategy:
      matrix:
        node:
          - '20'
          - '22'
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: ${{ matrix.node }}
      - run: |
          npm ci
          npm test

Qué vigilar en los archivos de flujo de trabajo

Alterna entre la salida del conversor y las mismas líneas escritas sin comillas, y compara cómo las lee cada versión de YAML.

La clave on

Un on sin comillas es true en YAML 1.1. Escribirlo entre comillas como 'on' deja contentos a todos los analizadores y linters.

Cadenas de versión

Los valores de la matriz como '20' o '3.10' siguen entre comillas, así que Python 3.10 nunca se convierte en 3.1.

Bloques run literales

Las cadenas con saltos de línea se convierten en bloques run: |, con cada comando en su propia línea.

Más herramientas

Conversores, validadores y guías paso a paso para cada lugar donde se encuentran JSON y YAML.

Preguntas frecuentes

¿Cómo convierto JSON en un flujo de trabajo de GitHub Actions?

Pega el JSON en el editor, copia el YAML y guárdalo en tu repositorio dentro de .github/workflows/, por ejemplo como .github/workflows/ci.yml. El flujo de trabajo se ejecuta en el siguiente evento que coincida.

¿Por qué la clave on se escribe como 'on'?

En YAML 1.1, un on sin comillas es el booleano true, así que algunas herramientas leen la clave del disparador como true en lugar de on. Las comillas eliminan la ambigüedad. GitHub acepta ambas formas, así que 'on': es seguro en todas partes.

¿Se conservan las expresiones ${{ }}?

Sí. Las expresiones como ${{ matrix.node }} y ${{ secrets.TOKEN }} son cadenas normales tanto en JSON como en YAML y se escriben exactamente como aparecen en la entrada.

¿Cómo se convierten los scripts run multilínea?

Una cadena JSON con saltos de línea \n se convierte en un bloque literal de YAML (run: |), con un comando por línea, que es como se suelen escribir los scripts de los flujos de trabajo.

¿Cómo compruebo un flujo de trabajo antes de hacer push?

Este conversor comprueba la sintaxis YAML. Para comprobaciones específicas de flujos de trabajo, como claves desconocidas, expresiones no válidas o etiquetas de runner incorrectas, ejecuta actionlint en local o en la CI.