Conversor de TOML para JSON

O que é TOML e porquê converter para JSON?

// Convert TOML to JSON in Node.js using the smol-toml library
import { parse } from 'smol-toml';

const toml = `
[package]
name = "my-app"
version = "1.0.0"

[dependencies]
serde = { version = "1.0", features = ["derive"] }
`;

const data = parse(toml);
const json = JSON.stringify(data, null, 2);

console.log(json);
// {
//   "package": { "name": "my-app", "version": "1.0.0" },
//   "dependencies": {
//     "serde": { "version": "1.0", "features": ["derive"] }
//   }
// }

Funcionalidades principais

Exemplos

[package]
name = "my-app"
version = "1.0.0"
edition = "2021"
authors = ["Jane Doe <jane@example.com>"]

[dependencies]
serde = { version = "1.0", features = ["derive"] }
tokio = { version = "1", features = ["full"] }

[dev-dependencies]
criterion = "0.5"

[[bin]]
name = "my-app"
path = "src/main.rs"

[build-system]
requires = ["hatchling"]
build-backend = "hatchling.build"

[project]
name = "my-package"
version = "0.3.1"
requires-python = ">=3.10"
dependencies = [
  "requests>=2.31",
  "pydantic>=2.0"
]

[project.optional-dependencies]
dev = ["pytest>=8.0", "ruff>=0.4"]

[tool.ruff]
line-length = 100

[build]
command = "npm run build"
publish = "dist"

[build.environment]
NODE_VERSION = "20"

[[redirects]]
from = "/old-path"
to = "/new-path"
status = 301
force = true

[[headers]]
for = "/*"

[headers.values]
X-Frame-Options = "DENY"

baseURL = "https://example.org"
languageCode = "en-us"
title = "My Hugo Site"
theme = "ananke"

[params]
description = "A static site built with Hugo"
mainSections = ["posts", "docs"]

[[menu.main]]
name = "Blog"
url = "/posts/"
weight = 1

[[menu.main]]
name = "About"
url = "/about/"
weight = 2

edition = "2021"
max_width = 100
hard_tabs = false
tab_spaces = 4
newline_style = "Unix"
use_small_heuristics = "Default"
reorder_imports = true
reorder_modules = true

title = "Deployment Log"
last_deployed = 1979-05-27T07:32:00Z
release_date = 1979-05-27
maintenance_window = 02:00:00

[[servers]]
name = "alpha"
ip = "10.0.0.1"
ports = [8001, 8002]

[[servers]]
name = "beta"
ip = "10.0.0.2"
ports = [9001]

Como usar

1. 1

   Cole o seu TOML

   Introduza ou cole o seu TOML no campo de entrada acima. Também pode clicar em 'Carregar exemplo' para experimentar um Cargo.toml, pyproject.toml ou config de deployment reais.

2. 2

   Veja a saída JSON ao vivo

   O JSON aparece instantaneamente no painel de saída. Ajuste a opção de Indentação (2 ou 4 espaços) para corresponder ao seu formato de destino. Datas, tabelas e arrays de tabelas são tratados automaticamente.

3. 3

   Copie ou Baixe

   Clique em Copiar para levar o JSON para a área de transferência, ou em Baixar para o guardar como ficheiro .json pronto para o seu programa, API ou ferramentas.

Armadilhas comuns do TOML

name = my-app

name = "my-app"

name = "a"
name = "b"

name = "a"
alt_name = "b"

released = 2026-7-2

released = 2026-07-02

ports = [8001, 8002

ports = [8001, 8002]

snowflake = 1420070400000000000

snowflake = "1420070400000000000"

[servers]
name = "a"
[servers]
name = "b"

[[servers]]
name = "a"
[[servers]]
name = "b"

Casos de uso comuns

Metadados do Cargo do Rust

Converta o Cargo.toml em JSON para construir painéis de dependências, auditar versões e features de crates ou alimentar dados do manifesto em scripts e CI que esperam JSON em vez de TOML.

Configuração de projeto Python

Converta o pyproject.toml em JSON para inspecionar os metadados de projeto PEP 621, extrair listas de dependências ou alimentar ferramentas que leem a configuração de packaging programaticamente.

Inspeção de config de deployment

Converta netlify.toml, foundry.toml ou outras configurações de plataforma em JSON para auditar redirecionamentos, cabeçalhos e definições de build, ou para gerar configuração equivalente para outra plataforma.

Migração de formato de configuração

Converta a configuração de aplicação em TOML para JSON ao migrar para um sistema que prefere JSON, ou como passo intermédio antes de transformar mais com ferramentas de JSON como o jq.

Definições de site estático

Converta o config.toml do Hugo em JSON para migrar as definições do site, comparar a configuração entre ambientes ou construir uma interface de definições apoiada em JSON.

Entrada de API e scripts

Transforme TOML escrito por humanos em JSON que uma API REST, uma função serverless ou um script de automação possa consumir diretamente, fazendo a ponte entre configuração legível e entrada de máquina.

Detalhes técnicos

Análise de TOML 1.0.0 via smol-toml

O TOML é analisado com a biblioteca smol-toml, um parser sem dependências e totalmente compatível com TOML 1.0.0. Trata corretamente tabelas aninhadas, chaves pontilhadas, tabelas inline, arrays de tabelas, strings multilinha e todos os quatro tipos de data-hora, e reporta erros de análise com posições de linha e coluna.

Data-hora sem perdas e tratamento seguro de inteiros

As datas-horas do TOML são serializadas para strings JSON que preservam o seu tipo exato (offset date-time, local date-time, data local, hora local). Os inteiros além do intervalo seguro do JavaScript (2^53 - 1) são promovidos a BigInt durante a análise e depois convertidos para o número JSON mais próximo com um aviso de precisão, para que TOML válido nunca falhe na conversão.

100% no navegador — Sem carregamento, sem servidor

Todo o processamento acontece no motor JavaScript do seu navegador. Nenhum dado é transmitido em momento algum. As entradas maiores que 200KB mudam do modo ao vivo para o manual (um clique explícito em Converter) para manter a interface responsiva.

Boas práticas

Guarde inteiros muito grandes como strings

Se o seu TOML tiver inteiros além de 2^53 - 1 (Snowflake IDs, timestamps em nanossegundos, contadores grandes), coloque-os entre aspas como strings antes de converter. Os números JSON no navegador não os conseguem guardar com exatidão, e a ferramenta avisá-lo-á quando tiver de arredondar.

Prefira indentação de 2 espaços para a saída JSON

A indentação de dois espaços é a convenção mais usada para JSON e produz uma saída limpa e legível que funciona bem com a maioria dos formatadores e ferramentas de comparação. Reserve a indentação de 4 espaços para quando um guia de estilo o exigir.

Valide a saída JSON antes de a usar

Depois de converter, se planeia editar o JSON à mão ou alimentá-lo num sítio exigente, passe-o pelo nosso Formatador JSON para confirmar que é válido e está formatado de forma consistente.

Mantenha os comentários do TOML em separado

O JSON não tem sintaxe de comentários, por isso os comentários # do TOML são descartados na conversão. Se os comentários forem documentação importante, mantenha o TOML original no controlo de versões junto do JSON gerado.

Use arrays de tabelas para secções repetidas

Quando tiver várias secções semelhantes (servidores, redirecionamentos, bins), escreva-as como arrays de tabelas ([[section]]) em vez de repetir [section]. Convertem-se num array JSON de objetos limpo em vez de causar um erro de tabela duplicada.

Perguntas frequentes