Formatador YAML

Formatador, minificador e validador de YAML online gratuito. Formate, minifique e valide YAML mostrando a linha e coluna exata do erro de sintaxe.

Tem feedback? Reporte bugs, sugira recursos ou compartilhe suas ideias — lemos todos

Formatador YAML - Formatar, Minificar e Validar YAML Online

Uma poderosa ferramenta online para formatar, minificar e validar YAML que ajuda você a embelezar, minificar e validar seu código. O validador analisa o arquivo com um analisador YAML real e relata a linha e coluna exata quando a análise falha. Possui destaque de sintaxe e indentação personalizável. Perfeito para desenvolvedores, engenheiros DevOps e qualquer pessoa que trabalhe com arquivos de configuração YAML do Kubernetes, Docker Compose, CI/CD, Ansible ou OpenAPI.

O que é YAML?

YAML (YAML Ain't Markup Language) é uma linguagem de serialização de dados legível por humanos. É comumente usada para:

- Arquivos de configuração (Docker, Kubernetes, CI/CD)
- Troca de dados entre linguagens de programação
- Configurações e preferências de aplicativos
- Infraestrutura como Código (Ansible, Terraform)
- Especificações de API (OpenAPI/Swagger)
- Geradores de sites estáticos (Jekyll, Hugo)

YAML foi projetado para ser fácil de ler e escrever. Usa indentação (espaços, não tabulações) para representar a estrutura e suporta:
- Pares chave-valor
- Listas (arrays)
- Estruturas aninhadas
- Vários tipos de dados (strings, números, booleanos)
- Comentários com #
- Strings multilinha

O que este Formatador YAML faz?

Esta ferramenta oferece duas funções principais:

1. Formatar (Embelezar): pega um YAML mal formatado e o torna legível com indentação e espaçamento adequados. Você pode escolher o tamanho da indentação (2, 4 ou 8 espaços) e opcionalmente preservar ou remover comentários.

2. Minificar: remove espaços em branco desnecessários e linhas em branco para criar um arquivo YAML mais compacto. Opcionalmente remove comentários. Útil para reduzir o tamanho do arquivo mantendo a legibilidade.

Observação: o YAML depende da indentação para a estrutura, então a minificação tem limites. Diferente de JSON ou XML, você não pode remover todos os espaços em branco. Esta ferramenta otimiza o YAML mantendo-o válido.

Ambas as funções incluem destaque de sintaxe para chaves, valores, comentários e caracteres especiais.

Como faço para formatar YAML?

Formatar YAML é simples:

1. Cole ou digite seu código YAML no campo de entrada
2. Selecione o tamanho de indentação preferido (2, 4 ou 8 espaços)
3. Opcionalmente marque/desmarque 'Preservar comentários'
4. Clique no botão 'Formatar'
5. Veja o YAML lindamente formatado na seção de saída

O YAML formatado terá:
- Indentação consistente em todo o arquivo
- Espaçamento adequado para legibilidade
- Destaque de sintaxe para chaves, valores e comentários
- Estrutura fácil de ler

Observação: o YAML usa espaços para indentação, nunca tabulações. Este formatador usa automaticamente espaços.

Por que a indentação do YAML é importante?

No YAML, a indentação não serve apenas para legibilidade - ela define a estrutura e o aninhamento dos dados:

Indentação correta:
pai:
filho1: valor1
filho2: valor2

Indentação incorreta (erro de sintaxe):
pai:
filho1: valor1
filho2: valor2

Regras principais:
- Use apenas espaços, nunca tabulações
- Seja consistente (use o mesmo tamanho de indentação em todo o arquivo)
- Elementos filhos devem ter mais indentação que o pai
- Itens no mesmo nível devem ter a mesma indentação

Misturar tabulações e espaços ou indentação inconsistente causará erros de análise. Este formatador garante espaçamento consistente em todo o seu YAML.

O que significa 'Preservar comentários'?

A opção 'Preservar comentários' controla se os comentários YAML são mantidos ou removidos:

Com preservar comentários (marcado):
# Configuração do banco de dados
db:
host: localhost # Endereço do servidor
port: 5432

Sem preservar comentários (desmarcado):
db:
host: localhost
port: 5432

Quando preservar:
- Durante desenvolvimento e depuração
- Quando os comentários contêm documentação importante
- Para arquivos de configuração que precisam de explicação

Quando remover:
- Para reduzir ligeiramente o tamanho do arquivo
- Para uma saída mais limpa
- Quando os comentários são notas temporárias

Observação: comentários YAML começam com # e continuam até o final da linha.

YAML vs JSON - qual devo usar?

YAML e JSON servem a propósitos semelhantes, mas têm pontos fortes diferentes:

Vantagens do YAML:
- Mais legível e editável por humanos
- Suporta comentários
- Menos verboso (não exige aspas, chaves, vírgulas)
- Melhor para arquivos de configuração
- Suporta tipos de dados complexos
- Strings multilinha são mais fáceis

Vantagens do JSON:
- Sintaxe mais simples (mais fácil de analisar)
- Melhor suporte de navegador/JavaScript
- Mais rápido de analisar
- Regras mais rígidas (menos ambiguidade)
- Melhor para APIs e troca de dados
- Tamanho de arquivo menor quando minificado

Use YAML para:
- Arquivos de configuração (Docker, Kubernetes, CI/CD)
- Arquivos editados por humanos
- Documentação que precisa de comentários

Use JSON para:
- Respostas e requisições de API
- Aplicações JavaScript
- Dados raramente editados manualmente
- Quando o desempenho de análise importa

Formatador YAML — Formatador, minificador e validador de YAML online gratuito. Formate, minifique e valide YAML mostrando a linha e coluna — **Formatador YAML**

Erros comuns de YAML e como evitá-los

Problemas comuns de sintaxe YAML:

1. Usar tabulações em vez de espaços:
Errado: [tab]chave: valor
Certo: [2 espaços]chave: valor

2. Indentação inconsistente:
Errado:
pai:
filho1: valor
filho2: valor
Certo:
pai:
filho1: valor
filho2: valor

3. Falta de espaço após os dois-pontos:
Errado: chave:valor
Certo: chave: valor

4. Sintaxe de lista incorreta:
Errado:
items:
- item1
- item2
Certo:
items:
- item1
- item2

5. Strings especiais sem aspas:
Errado: valor: yes # Analisado como booleano
Certo: valor: "yes" # Analisado como string

Este formatador ajuda você a manter indentação consistente e estrutura YAML adequada.

Como valido YAML e encontro o erro exato?

Clique no botão 'Validar'. A ferramenta analisa seu YAML com um analisador YAML real (o mesmo usado para formatar) e informa imediatamente se o documento é válido.

Se o YAML for válido, você recebe uma confirmação verde.

Se for inválido, você recebe um alerta vermelho com a mensagem de erro real do analisador e a linha e coluna exatas onde a análise falhou - por exemplo 'bad indentation of a mapping entry (12:5)'. Isso é muito mais útil do que um embelezador que 'conserta' silenciosamente uma entrada quebrada: você vê POR QUE um manifesto do Kubernetes, um arquivo Docker Compose ou um pipeline CI/CD falha ao analisar, e ONDE.

O botão Formatar agora faz o mesmo: se sua entrada não puder ser analisada, ele mostra o erro real em vez de produzir uma saída corrompida e uma falsa mensagem de sucesso.

Por que o YAML trata 'no', 'yes', 'on', 'off' de forma estranha? (O problema da Noruega)

Este é o famoso 'problema da Noruega' do YAML 1.1. No YAML 1.1, os escalares sem aspas yes/no/on/off/y/n (qualquer caixa) são convertidos em booleanos true/false. Assim, uma lista de países com 'NO' (Noruega) vira false, e 'country: no' é lido como 'country: false'.

O YAML 1.2 restringe isso apenas a true/false, mas muitos analisadores (e Kubernetes, Ansible, Docker Compose) ainda se comportam com a semântica 1.1, então a armadilha é bem real.

Solução: sempre coloque entre aspas os valores que você quer como strings - country: "NO", enabled: "yes". Números como um CEP com zero à esquerda (00123) e strings de versão (1.10) têm armadilhas de conversão semelhantes; coloque-os entre aspas também.

Armadilha relacionada: chaves duplicadas. Um mapeamento com a mesma chave duas vezes é inválido em YAML estrito e a maioria dos analisadores rejeita ou mantém silenciosamente o último valor - valide seu arquivo para detectar isso antes de publicar.

Valida âncoras, aliases, chaves de mesclagem e estilo de fluxo?

Sim. Como a validação usa um analisador YAML completo, ela entende corretamente a sintaxe avançada em que os engenheiros DevOps confiam:

- Âncoras e aliases (&nome / *nome) para reutilizar blocos
- Chaves de mesclagem (<<: *defaults) para herdar mapeamentos
- Estilo de fluxo ({chave: valor}, [a, b, c]) coleções em linha
- Escalares de bloco (| literal, > dobrado) para strings multilinha

Se algum deles estiver malformado - um alias apontando para uma âncora não definida, uma chave de mesclagem quebrada ou uma coleção de fluxo desbalanceada - o validador relata o erro de análise com sua linha e coluna. Observação: a validação verifica a sintaxe YAML, não a conformidade com um esquema específico (como um CRD do Kubernetes ou uma especificação OpenAPI); para validação de esquema, use um validador de esquema dedicado.

Meus dados YAML estão seguros?

Sim, seus dados estão completamente seguros e privados. Esta ferramenta:

- Processa todo o YAML inteiramente no seu navegador
- Não envia nenhum dado para nossos servidores
- Não armazena nem registra nenhum dos seus YAML
- Funciona offline depois que a página é carregada
- Não usa nenhum serviço externo

Você pode até se desconectar da internet após carregar a página e a ferramenta continuará funcionando perfeitamente. Seus dados YAML nunca saem do seu computador. Isso torna seguro formatar arquivos de configuração sensíveis.