O que é YAML? Guia para iniciantes com exemplos

Definição de YAML

YAML é um formato de texto para listas, mapas e configurações legíveis. Ele usa indentação para representar estrutura e evita muitas chaves e aspas. Essa clareza ajuda em manifests, pipelines e arquivos de configuração, desde que a equipe respeite espaços e valide tipos.

YAML significa YAML Ain't Markup Language. Ele não é markup como HTML; é um formato de dados, usado para listas, maps, strings, números, booleanos e null.

Sintaxe básica

YAML é um formato de texto para listas, mapas e configurações legíveis. Ele usa indentação para representar estrutura e evita muitas chaves e aspas. Essa clareza ajuda em manifests, pipelines e arquivos de configuração, desde que a equipe respeite espaços e valide tipos.

A base é formada por pares chave-valor, listas e indentação consistente:

app é um map com name e port. tags é uma lista. As linhas indentadas pertencem à chave acima.

YAML vs JSON

YAML é um formato de texto para listas, mapas e configurações legíveis. Ele usa indentação para representar estrutura e evita muitas chaves e aspas. Essa clareza ajuda em manifests, pipelines e arquivos de configuração, desde que a equipe respeite espaços e valide tipos.

JSON usa chaves, colchetes, vírgulas e strings com aspas. YAML usa layout e normalmente dispensa aspas em textos simples. Para uma comparação de escolha, leia JSON vs YAML.

Casos de uso reais

YAML é um formato de texto para listas, mapas e configurações legíveis. Ele usa indentação para representar estrutura e evita muitas chaves e aspas. Essa clareza ajuda em manifests, pipelines e arquivos de configuração, desde que a equipe respeite espaços e valide tipos.

Kubernetes, CI/CD e configurações de aplicação usam YAML porque pessoas revisam esses arquivos em Git. O valor aparece quando um diff precisa mostrar intenção, não apenas bytes.

Converter JSON para YAML

YAML é um formato de texto para listas, mapas e configurações legíveis. Ele usa indentação para representar estrutura e evita muitas chaves e aspas. Essa clareza ajuda em manifests, pipelines e arquivos de configuração, desde que a equipe respeite espaços e valide tipos.

Quando você já confia no JSON de uma API ou gerador, abra JSON to YAML e valide a saída com YAML Validator. Para automação, mantenha exemplos pequenos e tests de regressão.