Validador e formatador YAML

Cole o YAML para verificar a sintaxe, localizar erros e obter uma saída limpa e formatada de forma consistente.

Opções de saída

YAMLentrada

Vazio

YAMLsaída

A saída YAML aparece aqui

Funciona inteiramente no seu navegador: nada é enviado. Limites de uso justo se aplicam (5 MB por entrada, conversões com limite de frequência) para evitar spam e bots.

Carregar de URL

O arquivo é buscado diretamente pelo seu navegador, portanto o servidor precisa permitir requisições de outras origens.

Atalhos de teclado

Ctrl / ⌘ + Enter Converter agora
Ctrl / ⌘ + S Baixar a saída
Alt + Shift + C Copiar a saída
Alt + Shift + F Corrigir e formatar o JSON de entrada
Alt + Shift + S Inverter a direção
Alt + Shift + T Alternar entre as visualizações de código, árvore e mapa
Ctrl / ⌘ + Z Desfazer, inclusive Formatar, Corrigir e Limpar
Esc Sair da tela cheia
Tamanho do texto do editor

Padronize YAML bagunçado

Indentação misturada, mapas inline e aspas desnecessárias passam na análise, mas dificultam a revisão. A saída formatada dá a todo arquivo o mesmo formato.

Entrada
services:
    web:
        image: "nginx:1.27"
        ports: [ "80:80" ]
        environment: {LOG_LEVEL: info, DEBUG: 'false'}
Formatado
services:
  web:
    image: nginx:1.27
    ports:
      - '80:80'
    environment:
      LOG_LEVEL: info
      DEBUG: 'false'

Erros comuns de YAML e como corrigi-los

Estas são as mensagens que você verá com mais frequência, neste validador e em ferramentas como kubectl, Helm e docker compose.

Mensagem de erroO que significa e como corrigir
tab characters must not be used in indentation O YAML só permite espaços na indentação. Substitua cada tabulação por espaços.
bad indentation of a mapping entry Uma chave está indentada de forma diferente das chaves irmãs, ou um valor simples contém ": ". Alinhe a chave com as vizinhas ou coloque o valor entre aspas.
mapping values are not allowed in this context O mesmo problema como o kubectl e o Helm o informam: geralmente um valor sem aspas que contém ": ", como uma URL ou um horário. Coloque o valor entre aspas.
end of the stream or a document separator is expected Um item de lista ou uma chave está no nível de indentação errado, por exemplo uma lista seguida de um mapeamento no mesmo nível.
unexpected end of the stream within a flow collection Uma lista inline [ … ] ou um mapa { … } nunca é fechado. Adicione o colchete ou a chave que falta.
duplicated mapping key A mesma chave aparece duas vezes em um mapeamento. Remova ou renomeie uma delas.
unidentified alias Um alias como *defaults é usado antes da sua âncora &defaults, ou sem ela.

O que o validador verifica

Quebre o arquivo de propósito com os botões e veja qual verificação detecta o problema.

Sintaxe e indentação

Tabulações, chaves desalinhadas, aspas e colchetes não fechados são informados com a linha e a coluna exatas.

Chaves duplicadas

Uma chave definida duas vezes no mesmo mapeamento é um erro, enquanto alguns parsers mantêm o último valor sem avisar.

Âncoras e aliases

Todo alias deve apontar para uma âncora definida antes no documento, e as chaves de mesclagem devem referenciar mapeamentos.

Vários documentos

Cada documento de um arquivo separado por --- é analisado, e as notas mostram quantos foram encontrados.

Privado por padrão

A validação roda no seu navegador, então segredos em arquivos de CI e manifests nunca saem da sua máquina.

Mais ferramentas

Conversores, validadores e guias passo a passo para cada lugar onde JSON e YAML se encontram.

Perguntas frequentes

Como valido YAML online?

Cole seu YAML ou solte um arquivo .yaml ou .yml. O selo mostra YAML válido ou YAML inválido enquanto você digita. Para um arquivo inválido, você recebe a mensagem de erro com a linha e a coluna exatas, e a linha é destacada no editor.

O que a saída formatada faz?

Ela reescreve os mesmos dados com indentação e aspas consistentes: estilo de bloco, a indentação escolhida e aspas só onde necessário. É um jeito rápido de padronizar um arquivo antes do commit.

Os comentários são mantidos na saída formatada?

Não. O validador analisa o YAML como dados e o escreve de novo, e os comentários não fazem parte dos dados. Use a saída para verificar a estrutura e guarde o arquivo original se os comentários forem importantes.

Posso validar um arquivo YAML multidocumento?

Sim. Os documentos separados por --- são verificados um a um, e a saída formatada os mantém como documentos separados. As notas abaixo do editor mostram quantos documentos foram encontrados.

Ele verifica schemas do Kubernetes ou do Docker Compose?

Ele verifica a sintaxe YAML, não um schema específico. Um arquivo pode ser YAML válido e ainda assim ser rejeitado pelo kubectl ou pelo docker compose por um campo desconhecido. Use kubectl apply --dry-run=server ou docker compose config para verificar o schema.

Qual versão do YAML é usada?

A análise segue o schema core do YAML 1.2, então yes, no, on e off continuam strings. Com "Seguro para YAML 1.1" ativado, a saída coloca essas palavras entre aspas, para que parsers mais antigos, como o PyYAML, também as leiam como strings.