O que é um arquivo YAML?

YAML — configuração legível

O que é?

O YAML é um formato de configuração pensado para ser lido e escrito por humanos. Sem chaves, sem tags: a estrutura é definida pela indentação, como em uma lista com marcadores.

Ele aceita comentários, o que faz dele o formato preferido para arquivos de configuração — algo que o JSON, que os proíbe, torna francamente incômodo.

História e origem

O YAML surge em 2001, com a ambição declarada de ser mais legível que o XML e mais flexível que os formatos de configuração existentes.

Ele se consolidou em todo o ferramental moderno de desenvolvimento: integração contínua, orquestração de contêineres, implantação automatizada. Hoje, um engenheiro escreve YAML todos os dias.

Por que é prático

Muito legível e conciso, aceita comentários e lida com estruturas aninhadas com elegância.

Tecnicamente, é um superconjunto do JSON: todo arquivo JSON é um YAML válido.

Limites e defeitos

A indentação é significativa, e o uso de tabulação é proibido: um espaço a mais ou no lugar errado, e o arquivo muda de sentido ou se torna inválido.

Suas conversões automáticas de tipo são uma armadilha conhecida: em versões antigas, o valor NO — o código do país Noruega — era interpretado como o booleano "falso". Esse tipo de surpresa rendeu ao formato uma fama de ambiguidade.

Dicas de uso

O YAML é ideal para configurações escritas manualmente. Para troca de dados entre máquinas, converta-o para JSON: mais rígido, mais previsível, sem ambiguidade de tipos.

Coloque sempre entre aspas os valores que possam ser mal interpretados: sim, não, on, off, e qualquer coisa que pareça um número sem realmente ser um.

Converta seu YAML em segundos, nos nossos servidores seguros na França.

Converter um YAML