Formatador e Validador de YAML

Como Usar o Formatador e Validador YAML

Garanta que seus arquivos YAML estejam corretamente indentados e livres de erros de sintaxe com nossa ferramenta de validação e formatação.

1. Cole seu Código YAML: Insira seu conteúdo YAML na área de texto.
2. Clique em "Formatar YAML": A ferramenta irá analisar a estrutura do seu código. Se a sintaxe for válida, ela irá reformatá-lo com indentação consistente. Se houver um erro, como o uso de tabs ou uma indentação incorreta, a ferramenta irá apontá-lo.
3. Copie o Resultado: Use o botão "Copiar" para pegar o código YAML limpo e válido.

O que é YAML? (O "O Quê")

YAML (um acrônimo recursivo para "YAML Ain't Markup Language") é um formato de serialização de dados focado na **legibilidade humana**. É amplamente utilizado para arquivos de configuração em ferramentas de DevOps (como Docker, Kubernetes, Ansible) e em muitas outras aplicações, devido à sua sintaxe limpa e minimalista.

Sintaxe Essencial: As Regras de Ouro

A simplicidade do YAML depende de regras estritas. A maioria dos erros ocorre por violação de um destes pontos:

• Indentação é Tudo: A estrutura hierárquica é definida pela indentação. Use apenas espaços, nunca tabs. A consistência no número de espaços (geralmente 2) é crucial.
• Listas (Arrays): Itens em uma lista são denotados por um hífen seguido de um espaço (- item).
• Mapas (Objetos): Pares de chave-valor são definidos com dois-pontos seguidos de um espaço (chave: valor).
• Comentários: Comentários começam com o caractere de cerquilha (#).

Recursos Avançados para Configurações Poderosas

Dominar alguns conceitos avançados em YAML pode tornar seus arquivos de configuração muito mais poderosos e fáceis de manter (princípio DRY - Don't Repeat Yourself).

• Strings de Múltiplas Linhas: Para blocos de texto longos, como scripts ou chaves SSH, use:
  • | (Estilo Literal): Preserva as quebras de linha exatamente como foram escritas.
  • > (Estilo Dobrado): Converte quebras de linha em espaços, tratando o bloco como um único parágrafo.
• Âncoras e Aliases: Para reutilizar configurações, você pode "ancorar" um bloco com & e "aliá-lo" (reutilizá-lo) em outro lugar com *.

  padroes_job: &defaults
    docker_image: 'ubuntu:22.04'
    timeout: 60
  
  job_build:
    <<: *defaults
    script: ./build.sh

YAML vs. JSON: Qual a Melhor Escolha?

YAML é frequentemente considerado um superconjunto do JSON, o que significa que um JSON válido é também um YAML válido. A escolha entre eles depende do caso de uso.