JSON para YAML do GitHub Actions

Transforme uma definição de workflow em JSON em um arquivo .github/workflows limpo, pronto para o commit.

Opções de saída

JSONentrada

Vazio

YAMLsaída

A saída YAML aparece aqui

Funciona inteiramente no seu navegador: nada é enviado. Limites de uso justo se aplicam (5 MB por entrada, conversões com limite de frequência) para evitar spam e bots.

Carregar de URL

O arquivo é buscado diretamente pelo seu navegador, portanto o servidor precisa permitir requisições de outras origens.

Atalhos de teclado

Ctrl / ⌘ + Enter Converter agora
Ctrl / ⌘ + S Baixar a saída
Alt + Shift + C Copiar a saída
Alt + Shift + F Corrigir e formatar o JSON de entrada
Alt + Shift + S Inverter a direção
Alt + Shift + T Alternar entre as visualizações de código, árvore e mapa
Ctrl / ⌘ + Z Desfazer, inclusive Formatar, Corrigir e Limpar
Esc Sair da tela cheia
Tamanho do texto do editor

Um workflow, de JSON para YAML

Gatilhos, valores de matriz, expressões e scripts multilinha saem do jeito que você escreveria à mão.

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

Pontos de atenção em arquivos de workflow

Alterne entre a saída do conversor e as mesmas linhas escritas sem aspas e compare como cada versão do YAML as lê.

A chave on

Um on sem aspas é true no YAML 1.1. Escrevê-lo como 'on' deixa todos os parsers e linters satisfeitos.

Strings de versão

Valores de matriz como '20' ou '3.10' continuam entre aspas, então o Python 3.10 nunca vira 3.1.

Blocos run literais

Strings com quebras de linha viram blocos run: |, mantendo cada comando em sua própria linha.

Mais ferramentas

Conversores, validadores e guias passo a passo para cada lugar onde JSON e YAML se encontram.

Perguntas frequentes

Como converto JSON em um workflow do GitHub Actions?

Cole o JSON no editor, copie o YAML e salve-o no seu repositório em .github/workflows/, por exemplo .github/workflows/ci.yml. O workflow roda no próximo evento correspondente.

Por que a chave on é escrita como 'on'?

No YAML 1.1, um on sem aspas é o booleano true, então algumas ferramentas leem a chave do gatilho como true em vez de on. As aspas eliminam a ambiguidade. O GitHub aceita as duas formas, então 'on': é seguro em qualquer lugar.

As expressões ${{ }} são mantidas?

Sim. Expressões como ${{ matrix.node }} e ${{ secrets.TOKEN }} são strings simples tanto em JSON quanto em YAML e são escritas exatamente como aparecem na entrada.

Como os scripts run multilinha são convertidos?

Uma string JSON com quebras de linha \n vira um bloco literal YAML (run: |), com um comando por linha, que é como os scripts de workflow costumam ser escritos.

Como verifico um workflow antes de fazer o push?

Este conversor verifica a sintaxe YAML. Para verificações específicas de workflow, como chaves desconhecidas, expressões inválidas ou rótulos de runner errados, rode o actionlint localmente ou no CI.