O que é o formato de ficheiro YAML?
.yaml é um formato de arquivo de texto usado para trocar dados entre várias aplicações. YAML - abreviação de *YAML Ain't Markup Language* - é um padrão para organizar informações em um formato legível por humanos e independente de plataforma, usando pares key: value baseados em indentação codificados em UTF-8. A análise de arquivos .yaml requer a instalação de uma biblioteca YAML; bibliotecas populares incluem PyYAML (Python), js-yaml (JavaScript) e SnakeYAML (Java). Arquivos .yaml às vezes são salvos com a extensão .yml, que é funcionalmente idêntica. Além do intercâmbio de dados, os arquivos .yaml são normalmente usados para serializar dados e para escrever arquivos de configuração em ferramentas como Docker Compose, Kubernetes e GitHub Actions.
Serialização
A serialização é um termo usado na ciência da computação. É o processo de traduzir dados ou objetos em um formato que possa ser armazenado, transmitido e reconstruído posteriormente. Por exemplo, duas instituições que trocam dados em um formato padronizado usando aplicações diferentes devem serializar esses dados antes de enviá-los. Os dados serializados também podem ser armazenados em um arquivo - .yaml, .xml, .json, .toml, etc. - e depois enviados aos destinatários.
Um documento .yaml pode opcionalmente começar com o marcador de início de documento --- e terminar com ...; isso também permite múltiplos documentos dentro de um único arquivo. Desde o YAML 1.2 (2009, revisado em 2021), todo arquivo JSON válido também é um YAML válido.
Segurança e proteção
RISCO: MEDIUMUm arquivo YAML é texto simples e não é executado por conta própria, portanto, a leitura é segura. Dois riscos reais: (1) YAMLs de configuração (pipelines de CI, Compose, K8s, Ansible) frequentemente contêm segredos - tokens, senhas, chaves - portanto, não os cole em validadores online não confiáveis nem os envie para repositórios públicos. (2) Perigo programático: carregar YAML não confiável com um analisador inseguro (ex: yaml.load do PyYAML em vez de yaml.safe_load) pode executar objetos/código arbitrário - use sempre o carregador seguro para arquivos em que você não confia. Risco de edição: um tab ou um espaço desalinhado altera silenciosamente o significado, portanto, valide após editar.
Detalhes do formato
em resumoNOME COMPLETOYAML Ain't Markup Language file
DESENVOLVEDORClark Evans, Ingy döt Net, Oren Ben-Kiki (YAML spec)desde 2001 (YAML 1.0); YAML 1.1 (2005); current YAML 1.2 (2009, revised 2021)
CATEGORIAArquivos de Desenvolvedor
TIPO MIMEapplication/yaml
TIPOTexto de serialização de dados legível por humanos (baseado em indentação, UTF-8)
PADRÃOAberto · livre de royalties
Programas que abrem arquivos YAML
Windows4 apps
Sublime Text
Freemium Abra o .yaml para edição rápida com destaque YAML; configure «translate tabs to spaces» para que a indentação permaneça válida. 
Windows Notepad
Integrado Abre YAML como texto para uma visualização rápida - mas não mostra espaços/tabs, por isso é arriscado para editar YAML sensível à indentação. 
Notepad
Código aberto Abra com destaque de sintaxe YAML; ative Visualizar > Mostrar Símbolo > Mostrar Espaços em Branco para manter a indentação correta. 
Visual Studio Code
Gratuito Abra o arquivo; a extensão YAML integrada/da Red Hat oferece destaque, guias de indentação, validação de esquema e indicadores de erro. Melhor escolha para YAML. 
macOS3 apps
TextEdit
Integrado Vá em Formatar > Converter para Texto Simples primeiro e desative as aspas inteligentes - mas ele não mostrará espaços em branco, então prefira um editor de código para editar.
Visual Studio Code
Gratuito Abra o arquivo; a extensão YAML integrada/da Red Hat oferece destaque, guias de indentação, validação de esquema e indicadores de erro. Melhor escolha para YAML. 
Sublime Text / BBEdit
Freemium Abra o .yaml em um editor de código para destaque YAML adequado e indentação baseada em espaços. 
Linux3 apps
Visual Studio Code
Gratuito Abra o arquivo; a extensão YAML integrada/da Red Hat oferece destaque, guias de indentação, validação de esquema e indicadores de erro. Melhor escolha para YAML.
GNOME Text Editor / gedit
Código aberto Abra com destaque YAML; configure-o para inserir espaços (não tabs) antes de editar.
vim / nano
Código aberto Edite no terminal; no Vim use «:set expandtab» para que a indentação use espaços. Padrão para arquivos de configuração de servidor.
Web1 app
YAML Lint / online YAML validators
Gratuito Cole o arquivo para validar a sintaxe e formatá-lo no navegador. Não cole segredos - arquivos YAML de configuração geralmente contêm credenciais. Detalhes técnicos
especificação profunda| Extensão de arquivo | .yaml (também .yml) |
| Tipo MIME | application/yaml |
| Codificação | Texto simples UTF-8; sem cabeçalho binário ou magic bytes |
| Estrutura | Pares key: value baseados em indentação; a indentação usa apenas espaços - tabs são proibidos pela especificação |
| Marcadores de documento | --- marca o início do documento, ... marca o fim do documento; múltiplos documentos podem coexistir em um arquivo |
| Tipos de dados nativos | Strings, inteiros, floats, booleanos, null, sequências (listas), mapeamentos (dicionários), timestamps |
| Versão da especificação | YAML 1.2 (2009, revisado em 2021); substitui YAML 1.1 (2005) e YAML 1.0 (2001) |
| Compatibilidade com JSON | Desde o YAML 1.2, todo documento JSON válido também é um YAML válido - o JSON é um subconjunto estrito |
| Comentários | Comentários de linha única introduzidos por # ; podem aparecer em sua própria linha ou inline após um valor |
| Strings multilinha | Escalar de bloco literal (|) preserva quebras de linha; escalar dobrado (>) converte quebras de linha em espaços |
| Âncoras e aliases | & define uma âncora nomeada e * faz a referência (alias) a ela, permitindo o reuso de valores sem duplicação |
| Desenvolvedores | Clark Evans, Ingy döt Net, Oren Ben-Kiki |
| Casos de uso comuns | Arquivos de configuração (Kubernetes, Docker Compose, GitHub Actions, Ansible), serialização de dados, definições OpenAPI |
| Uso de aspas | Strings sem aspas, com aspas simples ('...') e aspas duplas ("...") são todas suportadas; aspas duplas permitem sequências de escape |
| Lançado | 2001 (YAML 1.0); YAML 1.1 (2005); current YAML 1.2 (2009, revised 2021) |
| Padrão aberto | Sim · livre de royalties |
| Especificação | yaml.org |
Conversões de YAML
Possível
.YAML .JSONGUIA
Sim - YAML e JSON compartilham o mesmo modelo de dados, portanto a conversão é lossless; apenas os…
Como converter
.YAML .XMLGUIA
Sim - tanto o YAML quanto o XML descrevem dados hierárquicos, portanto a conversão é direta, embora cada…
Como converter
.YAML .TOMLGUIA
Sim, YAML pode ser convertido para TOML -- o método mais rápido é um comando yq: yq -o=toml arquivo.yaml >…
Como converter
.YAML .CSVGUIA
Sim - mas apenas quando o arquivo .yaml é uma lista plana e uniforme de registros; configurações aninhadas,…
Como converter
.YAML .YMLGUIA
Sim - .yaml e .yml são o mesmo formato; renomear o arquivo é tudo o que você precisa fazer.
Como converter
Não é possível
Perguntas e Respostas da Comunidade
perguntado por usuários
I
Perguntas frequentes
Qual é a diferença entre .yaml e .yml?
Nenhuma - eles são o mesmo formato YAML com duas extensões. .yml é a forma mais antiga de 3 letras. Use a que a ferramenta esperar; você pode simplesmente renomear o arquivo.
Como abro um arquivo .yaml?
Com qualquer editor de código ou texto. O VS Code (com a extensão YAML) é o melhor porque destaca a estrutura e sinaliza erros de indentação; Notepad++ e Sublime também funcionam. É texto simples, então o Bloco de Notas abre - mas ele não mostrará os espaços em branco, com os quais o YAML se importa.
Por que meu YAML está dando erro de indentação/análise?
O YAML usa espaços para a estrutura e proíbe tabulações, então um tab perdido ou uma linha desalinhada o quebra. Abra-o em um editor compatível com YAML (que mostre espaços em branco, converta tabs em espaços) ou cole-o em um validador YAML online para encontrar a linha exata.
Como converto YAML para JSON?
Use «yq -o=json arquivo.yaml», um comando do VS Code ou um conversor online. É essencialmente sem perdas (lossless), já que o JSON é um subconjunto do YAML - apenas os comentários são descartados.
Posso usar tabs no YAML?
Não. O YAML permite apenas espaços para indentação; tabs causam erro de análise. Configure seu editor para inserir espaços (ex: «:set expandtab» no Vim, ou «translate tabs to spaces» no Sublime).
O YAML é apenas para Python?
Não - esse é um equívoco comum. O YAML é independente de linguagem e é usado em todos os lugares: Docker Compose, Kubernetes, GitHub Actions, Ansible, apps Go/Java/JS e mais. O Python apenas possui uma biblioteca YAML muito popular (PyYAML).
Referências
1YAML 1.2.2 Specification (yaml.org)yaml.org
2yaml.org - official site & resourcesyaml.org
