Como usar: Validador YAML
- Cole o YAML ou abra um arquivo
.yml/.yaml. - Os erros mostram a linha, a coluna e um indicador do ponto exato.
- Revise os avisos do linter sobre tabs, espaços no fim da linha e armadilhas do YAML 1.1.
- Copie o YAML formatado ou o equivalente em JSON.
Por que o YAML quebra com tanta facilidade
O YAML usa a indentação para definir a estrutura, então um único espaço fora do lugar muda o significado ou torna o arquivo inválido. Os erros mais comuns:
| Erro | Causa |
|---|---|
| bad indentation of a mapping entry | Uma chave está indentada de forma diferente das irmãs |
| found a tab character | O YAML proíbe tabs para indentação — use espaços |
| duplicated mapping key | A mesma chave aparece duas vezes no mesmo objeto; a maioria dos parsers mantém silenciosamente a última |
| incomplete explicit mapping pair / unexpected end | Uma aspa, colchete não fechado ou dois-pontos dentro de uma string sem aspas |
| end of the stream or a document separator is expected | Conteúdo com indentação errada depois de uma lista ou bloco |
Armadilhas do YAML 1.1 vs 1.2
Muitas ferramentas (PyYAML, bibliotecas antigas de Ruby e Go) ainda seguem o YAML 1.1, em que yes, no, on, off são booleanos e 012 é octal — o famoso “problema da Noruega”, em que o código de país NO vira false. O YAML 1.2 trata esses valores como strings. O linter sinaliza esses valores para que você possa colocá-los entre aspas e obter o mesmo resultado em todo lugar.
Arquivos multidocumento
Manifestos Kubernetes costumam combinar vários recursos separados por ---. Cada documento é validado e aparece na saída JSON como um array.
Validando o significado, não só a sintaxe
Um YAML válido ainda pode ser uma configuração errada. Para verificar a estrutura com um schema, converta para JSON e use o validador JSON Schema; para especificações de API, use o validador OpenAPI. Crie novos arquivos com o gerador de Docker Compose ou o gerador de GitHub Actions, e converta formatos com YAML para JSON.
Também pesquisado como: yaml lint, checar yaml, validar yaml online, yamllint online, formatador yaml, validador yaml kubernetes.
Ferramentas que combinam com: Validador YAML
- JSON para YAML — Cole seu JSON e receba YAML limpo para manifests do Kubernetes, Docker Compose, GitHub Actions ou qualquer arquivo de configuração.
- Gerador de YAML Kubernetes — Preencha o nome, a imagem e a porta do seu app e receba YAML do Kubernetes pronto para produção: um Deployment com probes, limites de recursos e contexto de segurança reforçado, além do Service, do Ingress com TLS, do ConfigMap, do Secret e do HorizontalPodAutoscaler que você marcar, tudo em um arquivo pronto para kubectl apply.
- Gerador de systemd Service — Rode seu app como um serviço Linux de verdade, que inicia com o sistema e reinicia quando trava.
- Gerador de GitLab CI — Escolha sua stack e receba um .gitlab-ci.yml funcionando: instalação com cache, jobs de lint e teste, build com artifacts, uma imagem Docker enviada ao registry do GitLab ou um deploy no GitLab Pages — com regras que rodam pipelines para merge requests e para sua branch padrão, sem duplicatas.