Ir para o conteúdo

Formatador YAML

Valide e reformate YAML com indicação clara de erros de linha e coluna.

Entrada
Saída

Formatador YAML

YAML aparece em todo lado: desde manifestos Kubernetes até workflows do GitHub Actions e ficheiros de configuração de aplicações — e é implacável com espaçamentos: um único espaço mal alinhado estraga o documento inteiro. Esta ferramenta verifica a sintaxe de um documento YAML e reformata-o consistentemente, para que possa detetar um pipeline ou ficheiro de configuração com falhas antes de ser executado.

Cole um documento e é analisado instantaneamente. A entrada válida é devolvida reformatada com a largura de indentação que escolhe; a entrada inválida devolve a linha e coluna exata do problema juntamente com o que o parser esperava ali, portanto não vai ter de adivinhar qual das quarenta linhas tem a tabulação perdida. Duas verificações executam automaticamente em cada documento válido: um aviso se alguma linha usar tabulação para indentação, uma vez que a especificação YAML proíbe tabulações mesmo que muitos editores as insiram por defeito, e uma contagem de chaves duplicadas dentro do mesmo mapeamento, o que YAML permite, mas geralmente significa que apenas a última vence e as outras são peso morto.

As opções controlam tanto a forma como o espaçamento. Ordene as chaves alfabeticamente para obter um documento determinístico e comparável — útil quando uma configuração gerada produz continuamente diffs de git ruidosos sem razão funcional. Compactar listas curtas transforma uma sequência escalar como uma lista de três linhas de tags numa única linha em estilo de fluxo como tags: [a, b, c]; deixe desligado e qualquer lista de fluxo inline na entrada será expandida de volta para um item por linha, o que é geralmente mais fácil de rever e mesclar. Remover comentários elimina comentários de linha completa e comentários hash finais para uma versão minificada, enquanto mantê-los ativados preserva os comentários do seu documento exatamente como estão escritos.

A formatação executa-se inteiramente no seu navegador. O YAML que cola nunca é carregado, registado ou enviado para qualquer lado — é analisado, reformatado e apresentado localmente, e desaparece quando fecha ou recarrega o separador.

FAQ

O meu YAML é enviado para algum lado?
Não. A análise e formatação ocorrem inteiramente no motor JavaScript do seu navegador. Nada do que cola é enviado para um servidor, registado ou armazenado fora do seu dispositivo.
O que significam a linha e coluna no erro?
Apontam para o local exato no seu documento onde o parser parou de compreender, contando a partir do topo e esquerda do texto que colou. Também indicam o que esperava ali, como indentação consistente ou um valor após dois pontos.
Porque é que avisa sobre tabulações?
A especificação YAML proíbe usar caracteres de tabulação para indentação — apenas espaços são permitidos. Um documento com indentação por tabulação pode ser analisado inconsistentemente, ou falhar completamente, numa implementação diferente de YAML, portanto a ferramenta sinaliza-o mesmo quando a sua entrada ainda é analisada aqui.
O que acontece com as chaves duplicadas?
YAML permite repetir uma chave dentro do mesmo mapeamento, e a maioria dos parsers mantém silenciosamente apenas o último valor. A ferramenta não o rejeita, mas conta os duplicados e marca a linha afetada para que possa decidir se foi intencional.
Consegue reparar YAML inválido para mim?
Não — diz-lhe exatamente onde a análise falhou para que possa reparar a fonte. Adivinhar automaticamente uma correção para indentação quebrada arriscaria alterar o significado do documento.