.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 estrutura | Hierárquico |
|---|---|
| Legibilidade humana | Alta |
| Suporte a aninhamento | Sim |
| Eficiência de tokens LLM | Média |
| Extensão do arquivo | .yaml |
| Tipo MIME | application/yaml |
| Indicado para | Manifestos 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
- JSON vs YAML vs TOML vs .env: Guia de Formatos de ConfiguraçãoCompare formatos de configuração JSON, YAML, TOML e .env em comentários, aninhamento e segurança de segredos — e converta localmente.
- Por que Sites de Colagem no Servidor Vazam Segredos — Arquitetura Zero-UploadEntenda por que colar .env, JWTs, CSVs ou contratos em sites na nuvem vaza dados — e como conferir 0 bytes enviados no seu navegador.
- Como mascarar dados CSV e JSON de clientes antes da análise com IAAnonimize colunas CSV sensíveis, escale receitas proporcionalmente (×k) e oculte chaves JSON aninhadas na RAM local sem quebrar a sintaxe.
- XML para JSON: preservando atributos, CDATA e feeds RSSConverta arquivos XML, RSS e SVG para JSON na RAM mantendo atributos @_, blocos CDATA, tipos numéricos e estrutura XML reversível.
Formatos relacionados
Todos os 24 formatosPerguntas 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.