Entrada YAML

Resultado da validação

O que é um validador YAML?

YAML (YAML Ain't Markup Language) é usado para ficheiros de configuração em Kubernetes, Docker Compose, GitHub Actions e muitas outras ferramentas. Ao contrário do JSON, o YAML usa indentação para a estrutura—sem parênteses necessários. Isso torna-o legível, mas também frágil: espaços incorretos, tabs em vez de espaços ou aninhamento inconsistente causam erros de análise. A especificação YAML 1.2 define as regras.

Um validador YAML verifica se o seu documento é válido. Analisa o seu YAML e reporta quaisquer erros de sintaxe com linha e posição. Esta ferramenta funciona inteiramente no seu navegador. Nada é enviado para um servidor—seguro para configs de produção, segredos ou dados sensíveis.

Exemplos de validação YAML

YAML válido usa indentação consistente. YAML inválido tem frequentemente aninhamento incorreto. Exemplos de telecomunicações:

Exemplo 1: YAML válido

Válido

Exemplo 2: YAML inválido (indentação incorreta)

Inválido

O validador reporta o erro. Use Amostra válida ou Amostra inválida acima para carregar exemplos no editor.

Como usar esta ferramenta

Colar ou carregar YAML

Copie o seu YAML e cole-o no editor esquerdo. Também pode clicar em Carregar para carregar um ficheiro .yaml ou .yml do seu computador. Use Amostra válida para YAML correto, ou Amostra inválida para ver como são os erros.

Verificar o resultado da validação

O painel direito mostra Válido ou Inválido. Se inválido, lista os erros com linha e posição para localizar o problema. Problemas comuns incluem indentação incorreta, tabs em vez de espaços, aninhamento inconsistente, caracteres especiais sem aspas ou strings multilinha malformadas.

Corrigir e revalidar

Corrija os erros na entrada e revalide. Para formatação e indentação, use o Formatador YAML. Para conversão para JSON ou outros formatos, use YAML para JSON ou YAML para XML.

Quando a validação YAML ajuda

A maioria dos programadores precisa de validação ao trabalhar com manifestos Kubernetes, ficheiros Docker Compose ou configs CI/CD como GitHub Actions. Um único espaço ou tab extra pode quebrar a implementação. Passar a sua config por aqui deteta erros de sintaxe antes de fazer push.

Ficheiros de config como <code>application.yml</code> (Spring Boot) ou <code>.gitlab-ci.yml</code> têm frequentemente aninhamento profundo. O validador ajuda a encontrar a linha exata onde a indentação está incorreta. Para converter YAML para JSON ou XML, use as ferramentas YAML para JSON ou YAML para XML.

Se estiver a editar YAML num editor sem boa validação, esta ferramenta dá-lhe feedback instantâneo. Também é útil antes de partilhar configs com a equipa—validar primeiro garante que todos recebem um ficheiro analisável.

Perguntas frequentes

O que torna o YAML inválido?

Indentação incorreta (tabs em vez de espaços), aninhamento inconsistente, caracteres especiais sem aspas como : ou # em valores, strings multilinha malformadas ou chaves duplicadas. O validador indica o problema com linha e posição.

Tabs vs espaços?

O YAML exige espaços para indentação. Tabs não são permitidos. Misturar tabs e espaços causa erros. Use 2 ou 4 espaços consistentemente em todo o ficheiro.

Os meus dados são enviados para algum sítio?

Não. A validação funciona inteiramente no seu navegador usando JavaScript. Nenhum dado é enviado para qualquer servidor. Pode confirmar isto abrindo o separador Rede do seu navegador enquanto usa a ferramenta.

E as âncoras e aliases YAML?

Âncoras (&name) e aliases (*name) são suportados. O validador verifica que são usados corretamente. Referências circulares farão a validação falhar.

Verifica esquema ou apenas sintaxe?

Esta ferramenta valida apenas a sintaxe—se o YAML está bem formado e analisável. Não valida contra um esquema JSON ou Kubernetes. Para validação de estrutura, converta para JSON e use o Gerador de esquema JSON.

Ferramentas relacionadas

Especificação YAML. Referência rápida YAML. Especificação JSON. MDN. Config Kubernetes. YAML. JSON Schema.

Validador YAML