Conversor de JSON para TOML online

JSON e TOML descrevem os mesmos dados de formas diferentes. O JSON usa chaves, colchetes e aspas para representar objetos e listas, enquanto o TOML organiza tudo em seções chamadas tabelas, com pares de chave e valor mais próximos de um arquivo de configuração comum. Converter de um para o outro faz sentido quando você recebe uma resposta de API em JSON e precisa de um arquivo legível para humanos, como um Cargo.toml de um projeto Rust ou um pyproject.toml de um projeto Python.

A principal diferença está na ênfase. O TOML foi pensado para ser fácil de ler e editar à mão, com sintaxe explícita para tabelas e seções. O JSON é mais compacto e voltado para troca de dados entre máquinas. Ao migrar de um formato para o outro, o conversor mapeia objetos JSON em tabelas TOML e arrays em listas equivalentes. Para o caminho inverso, use o conversor de TOML para JSON e mantenha os dois formatos sempre sincronizados.

O processo acontece em três etapas. Primeiro, o conversor lê o texto JSON e valida a estrutura. Se houver vírgula sobrando, aspas faltando ou chave não fechada, o erro é apontado antes de qualquer conversão. Em seguida, cada parte do JSON é mapeada para o equivalente em TOML.

A correspondência segue regras claras:

Por fim, o resultado é montado respeitando a indentação e a ordem das chaves. Objetos profundos viram tabelas com pontos no nome, como [servidor.banco], e listas de objetos viram arrays de tabelas. Você cola o JSON de um lado, confere a estrutura e copia o TOML pronto do outro. Para revisar o JSON antes, o formatador de JSON ajuda a deixar a entrada organizada.

A conversão de JSON para TOML aparece em situações bem específicas do dia a dia de quem desenvolve. O caso mais frequente é criar arquivos de configuração. Muitas ferramentas modernas leem TOML, como o Cargo do Rust, o Poetry do Python e o gerador de sites Hugo. Se você já tem as configurações em JSON, exportadas de um painel ou de um script, converter para TOML evita reescrever tudo à mão.

Outro cenário é a transformação de respostas de API. Um serviço devolve dados em JSON e você precisa gravá-los em um arquivo de configuração versionado no repositório. A conversão entrega um texto limpo, fácil de revisar em um pull request.

A migração entre sistemas também é comum. Ao trocar uma stack que usava JSON por outra baseada em TOML, converter os arquivos em lote economiza horas. E quando o time prefere YAML, o conversor de JSON para YAML cobre esse caminho com a mesma lógica de mapeamento.

Estruturas profundas exigem atenção. No JSON, um objeto dentro de outro é apenas mais um nível de chaves. No TOML, esse aninhamento pode virar uma tabela com nome pontilhado, como [app.cache.redis], ou uma tabela inline quando o objeto é pequeno. O conversor escolhe a forma mais legível com base no tamanho e na profundidade do dado.

Arrays de objetos são tratados como arrays de tabelas. Cada item da lista vira um bloco [[nome]] repetido, o que mantém o arquivo claro mesmo com dezenas de entradas.

Caracteres especiais também são resolvidos. Aspas, barras invertidas e quebras de linha dentro de valores recebem escape correto, e chaves com pontos ou espaços ganham aspas para não serem confundidas com separadores de tabela. Valores que parecem datas no formato ISO, como 12 de dezembro de 2024, podem ser convertidos em datas e horas nativas do TOML. Strings vazias, listas vazias e valores nulos seguem regras previsíveis para que nada se perca em silêncio.

Na maioria dos casos, a conversão de JSON para TOML preserva todos os dados. Strings, números, booleanos, objetos e arrays têm equivalentes diretos, então o conteúdo chega ao outro lado intacto. A diferença fica apenas na aparência do arquivo, que passa a usar tabelas e seções em vez de chaves e colchetes.

Existem dois pontos que merecem cuidado. O primeiro é o valor null. O TOML não tem um conceito nativo de nulo, então chaves nulas podem ser omitidas ou representadas como string vazia, dependendo da intenção. O segundo é a ordem das chaves: o JSON não garante ordem, mas o TOML costuma agrupar tabelas, o que pode reorganizar a posição visual sem alterar o significado.

Para conferir se nada mudou, converta o TOML de volta com o conversor de TOML para JSON e compare os dois JSON. Se eles forem equivalentes, a ida e a volta foram preservadas e o arquivo está pronto para uso em produção.