Formatador e Validador de YAML
Formate, valide e embeleze seu YAML online. Destaca erros de sintaxe instantaneamente com números de linha. Gratuito e executado inteiramente no seu navegador.
Como Usar
- Cole seu YAML na área de entrada
- Clique em «Formatar e Validar» para embelezar e verificar a sintaxe
- Se o YAML for inválido, uma mensagem de erro mostrará a linha exata e o problema
- Ajuste o seletor de indentação para controlar a indentação da saída
- Clique em «Copiar» para copiar o resultado formatado, ou em «Limpar» para redefinir
Perguntas Frequentes
-
O que é validação de YAML?
A validação de YAML verifica se o documento segue a sintaxe YAML correta — indentação adequada, sem chaves duplicadas, tipos de dados válidos e uso correto de caracteres especiais.
-
A formatação altera meus dados?
Não. A formatação altera apenas espaços em branco e indentação. A estrutura de dados e os valores permanecem exatamente iguais.
-
Quais são os erros de sintaxe YAML mais comuns?
Os erros comuns incluem indentação inconsistente (mistura de tabulações e espaços), falta de dois pontos após as chaves, strings sem aspas contendo caracteres especiais como : ou #, e chaves duplicadas.
-
Meu YAML é enviado para um servidor?
Não. Todo o formateo e validação ocorrem inteiramente no seu navegador usando a biblioteca js-yaml. Seus dados nunca saem do seu dispositivo.
-
Qual é a diferença entre YAML e JSON?
YAML é um superconjunto de JSON que suporta comentários, strings multilinha e é menos verboso. JSON usa chaves e aspas, enquanto YAML usa indentação. YAML é comumente usado em arquivos de configuração, JSON em APIs.
O Que é YAML?
YAML (acrônimo recursivo de "YAML Ain't Markup Language") é um formato de serialização de dados criado com foco na legibilidade humana. Diferente do XML, que usa tags, ou do JSON, que usa chaves e aspas, o YAML usa indentação por espaços para representar hierarquia — tornando-o visualmente limpo e fácil de editar diretamente.
Estrutura Básica do YAML
# Isso é um comentário — YAML suporta comentários, JSON não
servidor:
host: localhost
porta: 8080
ssl: true
bancos_de_dados:
- nome: producao
url: postgres://prod-server:5432/app
- nome: staging
url: postgres://staging-server:5432/app
O mesmo dado em JSON exigiria 20% mais caracteres e não suportaria o comentário.
YAML vs. JSON: Quando Usar Cada Um
| Característica | YAML | JSON |
|---|---|---|
| Comentários | Sim (#) |
Não |
| Strings multilinhas | Sim (` | e>`) |
| Verbosidade | Menor | Maior |
| Suporte em APIs | Limitado | Universal |
| Erros de sintaxe | Mais fácil de introduzir | Mais rigoroso |
| Parsing | Mais complexo | Simples e rápido |
Use YAML para: arquivos de configuração, Kubernetes manifests, pipelines CI/CD (GitHub Actions, GitLab CI), Ansible playbooks, Docker Compose.
Use JSON para: respostas de APIs REST, configurações de ferramentas JavaScript (package.json), intercâmbio de dados entre sistemas.
Erros de Sintaxe YAML Mais Comuns
Mistura de Tabulações e Espaços
YAML não permite tabulações para indentação — apenas espaços. Um tab invisível pode causar um erro found character that cannot start any token. Muitos editores de texto inserem tabs automaticamente, e o formatador ajuda a identificar e corrigir esse problema.
Strings com Caracteres Especiais
Alguns caracteres têm significado especial em YAML e precisam de aspas quando usados em valores:
# ERRADO — o : faz o parser pensar que é um novo par chave-valor
mensagem: Erro: arquivo não encontrado
# CORRETO
mensagem: "Erro: arquivo não encontrado"
Caracteres que exigem cuidado: :, #, [, ], {, }, ,, &, *, |, >, ', ", !.
Indentação Inconsistente
O YAML requer que todos os elementos de um mesmo nível estejam na mesma coluna de indentação. Indentar 2 espaços em um lugar e 4 espaços em outro dentro do mesmo bloco gera erro.
Chaves Duplicadas
YAML tecnicamente permite chaves duplicadas, mas o comportamento é indefinido — alguns parsers usam a primeira ocorrência, outros a última. Evite chaves duplicadas; nosso formatador os detecta.
Strings Multilinhas no YAML
O YAML oferece dois estilos para strings longas:
- Literal (
|): preserva quebras de linha exatamente como escritas — ideal para scripts e código - Dobrado (
>): converte quebras de linha em espaços — ideal para parágrafos de texto
script_deploy: |
#!/bin/bash
npm install
npm run build
descricao: >
Este é um texto longo que
será dobrado em uma única linha.
Validação Como Prática de DevOps
Em ambientes de DevOps, um arquivo YAML inválido pode derrubar um deploy inteiro. Validar o YAML localmente antes de fazer commit — especialmente para Kubernetes manifests e pipelines de CI — é uma prática que economiza tempo e evita incidentes em produção.