Ferramenta para desenvolvedores

Formatador de YAML

Cole o YAML. Receba-o limpo de volta ou descubra exatamente qual linha está errada.

Formatador de YAML Roda no seu dispositivo
  • Executa no seu navegador — seu texto nunca é enviado a lugar nenhum
  • Sem cadastro, sem cotas, grátis para usar quantas vezes quiser

Como funciona

Todo o design do YAML se apoia na indentação, o que o torna agradável de ler e incomumente fácil de quebrar. Um único espaço fora do lugar gera uma mensagem de erro de um pipeline de CI vinte minutos depois. Aqui ele é analisado na hora e você descobre imediatamente.

Validação com número da linha

Se o documento não for analisado, você recebe a linha e a coluna em que falhou e o motivo apontado pelo próprio analisador. Isso quase sempre é mais útil do que a saída formatada, e é o motivo pelo qual a maioria das pessoas abre uma ferramenta como esta.

Reformatação

O YAML válido é analisado como uma estrutura de dados e escrito de novo do zero, então a indentação fica uniforme, as aspas são normalizadas e os espaços em branco sobrando no fim das linhas desaparecem. Como o processo passa pelos dados em vez de editar o texto, o resultado é garantidamente válido.

O que o processo de ida e volta custa

Os comentários se perdem. Eles não fazem parte dos dados, então um analisador os descarta. Âncoras e aliases são expandidos para os valores completos em vez de preservados. Se os comentários do seu arquivo importam, formate uma cópia e aplique as correções de indentação à mão.

Ordenar as chaves

A ordem alfabética torna dois arquivos de configuração realmente comparáveis em um diff. Também é a escolha errada para um arquivo em que a ordem tem significado para quem lê — um pipeline de CI fica mais legível na ordem de execução do que na ordem alfabética.

Vários documentos

Um arquivo com vários documentos separados por --- é aceito, e cada um é formatado em sequência.

Perguntas frequentes

Formatador de YAML — perguntas

Por que meus comentários sumiram?

A formatação analisa o YAML como dados e o escreve de novo, e os comentários não fazem parte dos dados. Formate uma cópia se precisar mantê-los.

Ele diz onde está o erro?

Sim, com a linha, a coluna e a explicação do próprio analisador.

Meu YAML é enviado?

Não. Ele é analisado no seu navegador, o que importa, já que o YAML costuma guardar segredos e detalhes de infraestrutura.

Ele lida com vários documentos em um arquivo?

Sim, os documentos separados por --- são formatados um a um.

Devo ordenar as chaves?

É útil para comparar dois arquivos de configuração. Não ajuda quando a ordem tem significado para quem lê.