Convertidor de TOML a JSON

¿Qué es TOML y por qué convertirlo a 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"] }
//   }
// }

Características clave

Ejemplos

[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]

Cómo usarlo

1. 1

   Pega tu TOML

   Introduce o pega tu TOML en el campo de entrada de arriba. También puedes pulsar 'Cargar ejemplo' para probar un Cargo.toml, un pyproject.toml o una configuración de despliegue reales.

2. 2

   Observa la salida JSON en vivo

   El JSON aparece al instante en el panel de salida. Ajusta la opción de Indentación (2 o 4 espacios) para que coincida con tu formato de destino. Las fechas, las tablas y los arrays de tablas se gestionan automáticamente.

3. 3

   Copia o descarga

   Pulsa Copiar para llevar el JSON al portapapeles o Descargar para guardarlo como archivo .json, listo para tu programa, API o herramientas.

Errores comunes de 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 comunes

Metadatos de Cargo en Rust

Convierte Cargo.toml a JSON para crear paneles de dependencias, auditar versiones y características de los crates o alimentar los datos del manifiesto a scripts y CI que esperan JSON en lugar de TOML.

Configuración de proyecto Python

Convierte pyproject.toml a JSON para inspeccionar los metadatos de proyecto de PEP 621, extraer listas de dependencias o alimentar herramientas que leen la configuración de empaquetado de forma programática.

Inspección de configuración de despliegue

Convierte netlify.toml, foundry.toml u otras configuraciones de plataforma a JSON para auditar redirecciones, cabeceras y ajustes de compilación, o para generar una configuración equivalente para otra plataforma.

Migración de formato de configuración

Convierte la configuración de aplicación en TOML a JSON al pasar a un sistema que prefiere JSON, o como paso intermedio antes de transformarla más con herramientas JSON como jq.

Ajustes de sitios estáticos

Convierte el config.toml de Hugo a JSON para migrar los ajustes del sitio, comparar la configuración entre entornos o crear una interfaz de ajustes respaldada por JSON.

Entrada para API y scripts

Convierte TOML escrito por personas en JSON que una API REST, una función sin servidor o un script de automatización puedan consumir directamente, tendiendo un puente entre la configuración legible y la entrada de máquina.

Detalles técnicos

Análisis de TOML 1.0.0 con smol-toml

TOML se analiza con la biblioteca smol-toml, un analizador sin dependencias y totalmente conforme a TOML 1.0.0. Gestiona correctamente las tablas anidadas, las claves con puntos, las tablas en línea, los arrays de tablas, las cadenas multilínea y los cuatro tipos de fecha y hora, y comunica los errores de análisis con la línea y la columna.

Fecha-hora sin pérdidas y manejo seguro de enteros

Las fechas y horas de TOML se serializan en cadenas JSON que conservan su tipo exacto (fecha-hora con desfase, fecha-hora local, fecha local, hora local). Los enteros que superan el rango seguro de JavaScript (2^53 - 1) se promueven a BigInt durante el análisis y luego se convierten al número JSON más cercano con una advertencia de precisión, de modo que un TOML válido nunca deja de convertirse.

100% en el navegador: sin subidas, sin servidor

Todo el procesamiento ocurre en el motor JavaScript de tu navegador. En ningún momento se transmiten datos. Las entradas mayores de 200 KB pasan del modo en vivo al modo manual (una pulsación explícita en Convertir) para mantener la interfaz con buena respuesta.

Buenas prácticas

Guarda los enteros muy grandes como cadenas

Si tu TOML tiene enteros que superan 2^53 - 1 (IDs de Snowflake, marcas de tiempo en nanosegundos, contadores grandes), ponlos entre comillas como cadenas antes de convertir. Los números JSON en el navegador no pueden contenerlos exactamente, y la herramienta te avisará cuando tenga que redondear.

Prefiere la indentación de 2 espacios para la salida JSON

La indentación de dos espacios es la convención más usada para JSON y produce una salida limpia y legible que funciona bien con la mayoría de formateadores y herramientas de comparación. Reserva la indentación de 4 espacios para cuando una guía de estilo lo exija.

Valida la salida JSON antes de usarla

Después de convertir, si piensas editar el JSON a mano o alimentarlo a algo estricto, pásalo por nuestro Formateador de JSON para confirmar que es válido y que tiene un formato coherente.

Guarda los comentarios de TOML por separado

JSON no tiene sintaxis de comentarios, así que los comentarios # de TOML se descartan al convertir. Si los comentarios son documentación importante, mantén el TOML original en el control de versiones junto al JSON generado.

Usa arrays de tablas para secciones repetidas

Cuando tengas varias secciones similares (servidores, redirecciones, bins), escríbelas como arrays de tablas ([[section]]) en lugar de repetir [section]. Se convierten en un array JSON de objetos limpio en vez de provocar un error de tabla duplicada.

Preguntas frecuentes