.yaml · application/yaml

YAML: Linguagem de Serialização de Dados YAML

YAML 1.2 é uma linguagem de serialização sensível à indentação que suporta comentários, âncoras, strings multilinhas e fluxos multi-documento separados por ---.

Resposta rápida: YAML 1.2 é uma linguagem de serialização sensível à indentação que suporta comentários, âncoras, strings multilinhas e fluxos multi-documento separados por ---. Manifestos Kubernetes, fluxos do GitHub Actions, arquivos Docker Compose e configurações editadas por humanos.

Tipo de estruturaHierárquico
Legibilidade humanaAlta
Suporte a aninhamentoSim
Eficiência de tokens LLMMédia
Extensão do arquivo.yaml
Tipo MIMEapplication/yaml
Indicado paraManifestos Kubernetes, fluxos do GitHub Actions, arquivos Docker Compose e configurações editadas por humanos.

Pontos fortes

  • Suporta comentários inline com # e blocos multilinhas limpos sem chaves
  • Permite vários documentos em um único arquivo com separadores ---
  • Superset nativo do JSON com ótima legibilidade para manifestos de infraestrutura

Limitações

  • Erros de indentação por espaços podem quebrar a estrutura silenciosamente
  • Escalares sem aspas em YAML 1.1 como NO ou ON viram booleanos inesperadamente
  • Especificação extensa e referências de âncoras aumentam a complexidade de parsing

Referências

Converter e limpar YAML localmente

Guias técnicos relacionados

Formatos relacionados

Todos os 24 formatos

Perguntas frequentes sobre YAML

O que é o problema da Noruega (Norway problem) no YAML?

No YAML 1.1, códigos de país sem aspas como NO ou valores como yes/on/off são interpretados como booleanos em vez de strings. Sempre use aspas ou confira a saída JSON.

Um único arquivo YAML pode conter vários documentos?

Sim. Manifestos Kubernetes costumam separar vários recursos usando linhas ---, que o conversor YAML para JSON analisa via loadAll multi-documento.

Existe diferença entre .yml e .yaml?

Não. Ambas as extensões usam sintaxe YAML idêntica; .yaml é a recomendação oficial, embora .yml seja comum em arquivos de CI e Docker.