TOML

O que é um arquivo TOML?

Um formato de configuração que se mantém legível sem herdar as armadilhas de indentação do YAML.

O que é TOML

TOML é um formato de texto puro que abre em qualquer editor. Ele é usado para a edição.

A extensão é .toml e o nome por extenso é Tom's Obvious Minimal Language. Os dois importam menos do que aquilo que o arquivo consegue carregar, e é disso que trata o resto desta página.

De onde vem TOML

Ele remonta a 2013. A especificação é TOML 1.0.

A idade interessa por um motivo prático: quanto mais antigo o formato, mais programas tiveram tempo de aprendê-lo.

A especificação é pública

Qualquer um pode implementá-la sem pedir permissão nem pagar licença. É por isso que o formato aparece em tantos programas, e é por isso que arquivos escritos há vinte anos ainda abrem.

Nada é jogado fora

TOML guarda o conteúdo exatamente. Salvar de novo não muda nada, então dá para abrir, editar e salvar quantas vezes você quiser sem acumular estrago — e é isso que faz dele um formato de trabalho e não de entrega.

Dá para deixar anotações

TOML tem sintaxe de comentário — essa é a diferença entre um arquivo que uma pessoa mantém e um que um programa escreve. Os comentários são a primeira coisa perdida na conversão para um formato que não os tem, e nada avisa.

O que abre TOML

Visual Studio Code lê esse formato, e a maioria dos programas do mesmo tipo também.

Quando um arquivo não abre, o formato raramente é o problema — mais comum é o programa ser mais antigo que ele. Converter para algo mais antigo é o caminho confiável, e é para isso que serve o resto deste site.

Abrir no navegador

Nenhum navegador lê o formato.

Esse é de longe o motivo mais comum para convertê-lo: não que o formato seja ruim, mas que o lugar onde você quer mostrar o arquivo não consegue lê-lo.

É um formato de trabalho

TOML foi feito para ser aberto e alterado. Mantenha o arquivo nesse formato enquanto o trabalho estiver em andamento e exporte a partir dele sempre que precisar de uma cópia pronta.

Os dados, num lugar só

Identificadores e procedência do formato TOML.
Extensão.toml
Tipo de mídiaapplication/toml
Primeira publicação2013
EspecificaçãoTOML 1.0

Converter TOML para outra coisa

Converter outra coisa para TOML

Formatos a considerar no lugar de TOML