Formatador YAML
Por que formatar arquivos YAML?
O YAML é extremamente sensível ao recuo — um único espaço extra pode provocar erros de parsing ou corrupção silenciosa de dados. Ferramentas como Kubernetes, Docker Compose, GitHub Actions e Ansible usam arquivos de configuração YAML onde erros de formatação podem paralisar deploys inteiros. Nosso formatador valida a sintaxe, normaliza o recuo e garante que seu YAML esteja sempre correto.
Normalização de recuo
Normaliza recuos mistos para um formato consistente de 2 espaços em todo o documento
Validação de sintaxe
Detecta erros de recuo, misturas de tabs/espaços e problemas estruturais antes de falhas em produção
Âncoras e aliases
Suporte completo para âncoras (&) e aliases (*) do YAML para reutilização de documentos e configurações DRY
Como formatar YAML em 3 passos
Cole seu YAML
Cole seu manifesto do Kubernetes, workflow do GitHub Actions ou qualquer arquivo de configuração YAML
Formatar e validar
A ferramenta valida a sintaxe e reformata automaticamente com recuo consistente
Copiar e implantar
Copie o YAML formatado para seu arquivo, pipeline CI ou ferramenta de deploy
Casos de uso da formatação YAML
Manifestos do Kubernetes
Formate arquivos YAML de Deployment, Service e ConfigMap antes de aplicá-los a um cluster
Pipelines CI/CD
Valide workflows do GitHub Actions, GitLab CI e CircleCI para evitar falhas no pipeline
Playbooks do Ansible
Formate e valide tarefas, variáveis e inventários do Ansible para código de infraestrutura limpo
Docker Compose
Certifique-se de que arquivos docker-compose.yml estão corretamente formatados antes de executar docker compose up
Boas práticas YAML
✓ Use espaços, nunca tabs
YAML proíbe estritamente o caractere tab para recuo. Configure sempre seu editor para inserir espaços ao pressionar Tab em arquivos YAML.
✓ Coloque entre aspas os caracteres especiais
Strings com : # [ ] { } ou que começam com caracteres especiais devem ser colocadas entre aspas para evitar má interpretação pelo YAML.
✓ Use âncoras para reduzir duplicações
As âncoras YAML (&nome) e os aliases (*nome) permitem reutilizar valores em um documento, reduzindo repetições em configurações complexas.
✓ Lint antes do commit
Execute yamllint ou use este formatador em seu hook pre-commit para detectar problemas de formatação antes de chegarem ao repositório.
❓ Perguntas frequentes
Por que o YAML falha com tabs em vez de espaços?
A especificação YAML proíbe explicitamente os caracteres tab para recuo, pois diferentes editores exibem tabs com larguras diferentes. Os espaços fornecem recuo consistente e inequívoco que todos os parsers YAML podem interpretar de forma idêntica.
O que fazem as âncoras (&) e os aliases (*) no YAML?
As âncoras definem um bloco reutilizável com &nome-ancora: e os aliases o referenciam com *nome-ancora. Isso permite definir valores uma vez e reutilizá-los várias vezes, mantendo as configurações DRY.
Qual é a diferença entre YAML e JSON?
YAML é um superconjunto de JSON — todo JSON válido é YAML válido. YAML adiciona suporte a comentários, âncoras, strings multilinha e sintaxe mais legível. JSON é melhor para troca de dados entre máquinas; YAML é mais adequado para configuração editada por humanos.
Por que escolher YAML em vez de TOML para configuração?
YAML tem suporte de ferramentas mais amplo (Kubernetes, Ansible, a maioria dos sistemas CI) e pode representar estruturas aninhadas complexas de forma concisa. TOML é mais simples e menos propenso a erros para configurações básicas. Para configuração DevOps, YAML é o padrão.