Formatador YAML
Formatar, minificar e validar YAML com destaque de sintaxe
Entrada YAML
Saída formatada
O que é um formatador YAML?
YAML (YAML Ain't Markup Language) é amplamente utilizado para ficheiros de configuração em Kubernetes, Docker Compose, GitHub Actions e muitas outras ferramentas. Ao contrário do JSON, o YAML usa indentação para a estrutura—sem parênteses necessários. Isso torna-o legível, mas também frágil: espaços incorretos, tabs em vez de espaços ou aninhamento inconsistente causam erros de análise. A especificação YAML 1.2 define as regras.
Um formatador YAML normaliza a indentação e as quebras de linha para que o seu documento seja válido e consistente. Esta ferramenta analisa o seu YAML e reformata-o com 2 ou 4 espaços. Funciona inteiramente no seu navegador. Nada é enviado para um servidor—seguro para configs de produção, segredos ou dados sensíveis.
Exemplos de formatação YAML
Formatar YAML para indentação consistente. Exemplos de telecomunicações:
Exemplo 1: Registo de assinante
Saída formatada:
Exemplo 2: Lista de assinantes
Saída formatada:
Clique no botão Amostra acima para carregar mais exemplos no editor.
Como usar esta ferramenta
Colar ou carregar
Copie o seu YAML e cole-o no editor esquerdo. Também pode clicar em <strong>Carregar</strong> para carregar um ficheiro <code>.yaml</code> ou <code>.yml</code>. O botão <strong>Amostra</strong> carrega dados de exemplo. YAML inválido mostrará um erro—use o Validador YAML para diagnosticar.
Ajustar e ver a saída
O painel direito atualiza-se automaticamente. Use os botões de indentação (2 ou 4 espaços) para escolher o seu estilo preferido. Ordenar chaves alfabetiza as chaves para saída consistente. A especificação YAML exige espaços (não tabs) para indentação.
Copiar ou descarregar
Use <strong>Copiar</strong> para colocar o resultado na área de transferência, ou <strong>Descarregar</strong> para guardar como ficheiro. Para converter para JSON, use YAML para JSON. Para o inverso, use JSON para YAML. Para saída compacta, use o Minificador YAML.
Quando a formatação YAML ajuda
A maioria dos programadores precisa de um formatador ao trabalhar com manifestos Kubernetes, ficheiros Docker Compose ou configs CI/CD como GitHub Actions. O YAML editado manualmente tem frequentemente erros de indentação—um único espaço ou tab extra pode quebrar a implementação. Formatá-lo aqui dá-lhe uma saída válida e consistente que pode colar de volta no seu projeto.
Ficheiros de config como <code>application.yml</code> (Spring Boot) ou <code>.gitlab-ci.yml</code> têm frequentemente aninhamento profundo. Indentação inconsistente torna-os difíceis de ler e rever em pull requests. Passá-los por aqui normaliza a estrutura. Para converter para JSON ou XML, use YAML para JSON ou YAML para XML.
Também é útil antes de partilhar YAML com a equipa. Config formatada numa mensagem Slack ou num ticket é muito mais fácil de ler. Passá-la primeiro pelo Validador YAML pode detetar problemas de sintaxe antes de outros os verem.
Perguntas frequentes
Os meus dados são privados?
Sim. A formatação ocorre no seu navegador usando JavaScript. Nenhum dado é enviado para qualquer servidor. Pode confirmar isto abrindo o separador Rede do seu navegador enquanto usa a ferramenta.
Por que o YAML usa espaços em vez de tabs?
A especificação YAML exige espaços para indentação. Tabs não são permitidos. Misturar tabs e espaços causa erros de análise. Use 2 ou 4 espaços consistentemente em todo o ficheiro.
Posso converter YAML para JSON?
Sim. Use a ferramenta YAML para JSON.
E se o meu YAML tiver indentação inválida?
A ferramenta mostrará um erro de análise com linha e posição. Use o Validador YAML para obter mensagens de erro detalhadas. Correções comuns: substituir tabs por espaços, garantir tamanho de indentação consistente e verificar blocos aninhados desalinhados.
Isto preserva comentários?
Depende do analisador. Algumas implementações removem comentários ao analisar e reemitir. Verifique a saída.
Ferramentas relacionadas
Para mais informações sobre YAML, a especificação YAML 1.2 é a referência formal. Consulte também yaml.org, config Kubernetes, Docker Compose.