Format Atlas

Comparar

YAML vs TOML

YAML e TOML são formatos de texto usados em configurações editadas por pessoas. YAML aceita hierarquias flexíveis; TOML prioriza opções explícitas e legíveis com chaves e tabelas. Escolha conforme a ferramenta e a estrutura dos dados.

Qual formato você deve escolher?

Use YAML se a ferramenta exigir ou se a configuração precisar de aninhamento complexo. Considere TOML para configurações simples de aplicativo com tabelas e tipos claros.

Indicado para YAML

Arquivos de configuração e dados estruturados

  • Configurações mantidas por pessoas

Indicado para TOML

Configuração de aplicativos e ferramentas

  • Ajustes legíveis estruturados

Informações básicas

CampoYAMLTOML
Extensão.yaml, .yml.toml
Tipo MIMEapplication/yamlapplication/toml
Usos comunsArquivos de configuração e dados estruturadosConfiguração de aplicativos e ferramentas
Como abrirAbra em um editor de texto ou ferramenta YAML e preserve a indentação com espaços.Abra em editor de texto e consulte a documentação sobre o TOML compatível.
Exportar ou converterSe o destinatário exigir JSON, converta e verifique tipos e codificação de caracteres.Ao converter de JSON ou YAML, confira hierarquia, listas, aspas, datas e tipos após analisar.

Escolha por finalidade

Configurações mantidas por pessoas

Arquivos de configuração e dados estruturados

YAML

Ajustes legíveis estruturados

Configuração de aplicativos e ferramentas

TOML

Ponto principal 1

YAML permite estruturas hierárquicas ricas, mas exige cuidado com indentação e tipos implícitos.

Mais sobre as diferenças

Ponto principal 2

TOML usa sintaxe explícita de chave, valor e tabela voltada à leitura de configurações.

Mais sobre as diferenças

Mais sobre as diferenças

Siga o formato e a versão aceitos pela ferramenta de destino. Valide com o parser e o esquema reais, especialmente datas, números, estruturas aninhadas e sintaxe sensível a espaços.

  • YAML é comum em ferramentas de infraestrutura e automação que o exigem.
  • TOML pode deixar configurações de aplicativos mais claras, mas nem toda ferramenta baseada em YAML o aceita.
  • Os dois formatos podem ser interpretados incorretamente quando variam as opções do parser ou as regras de tipos.

Perguntas frequentes

TOML é mais simples que YAML?

Pode ser em muitos arquivos de configuração simples, mas os requisitos da ferramenta e a estrutura decidem. Use o formato aceito com confiabilidade pelo aplicativo.

Saiba mais

Usos e verificações relacionados

Escolha um formato de configuração

Referências e especificações