YAML é o formato de configuração padrão de Docker Compose, Kubernetes, pipelines de CI/CD e Ansible, e o formatador YAML gira em torno da pergunta de tornar esses arquivos legíveis de novo. Cole qualquer documento YAML, escolha um dos dois modos e a ferramenta reemite o documento inteiro com espaçamento consistente, inteiramente dentro do seu navegador. Nada é salvo nem enviado; o analisador e o serializador rodam na sua máquina.
Cole YAML e escolha um modo
Não há reformatação ao vivo: o documento é processado só quando você aperta um botão. Formatar é o modo padrão e reconstrói o documento em estilo bloco, o esquema de uma chave por linha que a maioria dos arquivos de configuração usa. Minificar mira em outro objetivo: produzir a representação mais compacta que o analisador consegue ler. Um seletor de indentação pequeno alterna Formatar entre 2 e 4 espaços; ele aparece só no modo Formatar porque Minificar usa sempre 2.
O que Formatar faz: um documento limpo em estilo bloco
Formatar normaliza todos os níveis do documento na indentação que você escolheu. Mapeamentos e sequências aninhados se alinham em deslocamentos fixos, espaços finais desaparecem e um nível sempre equivale a um passo de indentação. Valores longos nunca quebram linha: um valor de 400 caracteres fica em uma linha só, porque em arquivos de configuração a legibilidade da estrutura importa mais que o comprimento da linha.
O que Minificar faz: estilo flow sob um topo em bloco
Minificar não amassa o documento em uma linha só, e isso surpreende. O nível superior fica em estilo bloco, mas cada valor sob uma chave superior é escrito em forma flow: uma lista de strings vira items: [a, b] e um mapeamento aninhado vira a: {b: [1, 2]}. Uma lista de mapas no nível superior vira um mapa flow por linha, começando com um traço e uma chaveta de abertura. Valores que poderiam ser mal lidos em flow, como uma chave chamada y, ganham aspas para manter o sentido exato.
O que o formatador descarta e reescreve
Três coisas valem saber antes de comparar a saída. Comentários são descartados: o analisador transforma primeiro o documento em uma estrutura de dados e os comentários não sobrevivem a essa etapa. Âncoras e aliases são entendidos durante a análise, mas o serializador é configurado para não emitir referências, de modo que cada alias volta como uma cópia completa do valor ao qual aponta. Números também são normalizados: 3.0 vira 3, 1e5 vira 100000, 0x10 vira 16, e valores vazios, til e null saem como null, enquanto uma string vazia continua sendo string vazia, com aspas.
Ordem das chaves: mantida, com uma exceção
O formatador não ordena suas chaves. Chaves de string mantêm exatamente a ordem que tinham no seu documento, então um arquivo que lista zebra, ant e m volta nessa mesma ordem. Há uma exceção que pode parecer ordenação: uma chave que parece um inteiro, por exemplo 123, vai para o início do mapeamento. Não é o formatador escolhendo uma ordem; é a forma como o objeto de JavaScript que guarda o documento analisado lista suas propriedades, e chaves numéricas vêm sempre primeiro.
Mensagens de erro com linha e coluna
Um YAML inválido não produz uma falha vaga. O analisador informa o problema com número de linha e de coluna, ambos começando em 1, para você saltar direto ao ponto quebrado. Chaves duplicadas são rejeitadas do mesmo jeito, o que ajuda quando um bloco copiado se infiltra duas vezes. Um caso é diferente: um segundo marcador de documento na entrada também é erro, mas aquela mensagem não tem posição, porque o analisador para no nível do fluxo. Colar nada mostra uma mensagem dedicada.
Trocar, limpar e para onde ir a seguir
Dois controles pequenos fecham o fluxo. O botão Trocar aparece quando há saída e a copia de volta para a entrada, limpando a saída, o que acelera a correção iterativa: formatar, notar um valor para refazer, trocar, editar, formatar de novo. Limpar esvazia os dois lados e a linha de erro. Nada da página é salvo, então conteúdo de configuração sensível nunca sai do seu navegador. Se seus dados nascem como JSON, rode antes o Formatador JSON ou vá direto ao Conversor JSON/YAML. Configurações XML recebem o mesmo trato no Formatador XML, e para arquivos de marcação o guia do formatador HTML cobre o mesmo padrão de formatação e minificação com blocos de script protegidos.