Loading…

Acerca de Formateador TOML en Línea

¿Tienes configuraciones desordenadas en `pyproject.toml`, `Cargo.toml` o `poetry`? Pega tu TOML o suelta un archivo y nuestro formateador normalizará los espacios en blanco, ordenará los arrays y tablas en línea, y mantendrá tus secciones espaciadas consistentemente. Ideal para Python, Rust, Go, generadores de sitios estáticos y cualquier proyecto que utilice TOML para configuración.

Características Principales del Formateador TOML

  • **Embellecedor de un solo clic** para archivos y fragmentos de configuración TOML
  • **Tamaño de sangría configurable** de 1 a 8 espacios mediante el control deslizante *Tamaño de Sangría*
  • **Alternar estilo de sangría** – elige entre espacios o tabulaciones para la sangría
  • **Control de Ajuste / Longitud de Línea** para mantener arrays largos y tablas en línea dentro de un ancho de columna elegido
  • Compatible con archivos `.toml` como `pyproject.toml`, `Cargo.toml`, `Pipfile.toml`, `poetry.toml` y más
  • Analizador TOML basado en Prettier que comprende fechas, arrays, tablas anidadas y tablas en línea
  • Formateo estable e idempotente – volver a ejecutarlo en el mismo archivo no causará desviación de formato
  • Copia con un clic de la salida formateada, lista para tu editor o commit

🛠️ Cómo Formatear Archivos TOML en Línea for toml-formatter

1

1. Pega o Sube Tu TOML

📥 Pega TOML en el editor o arrastra y suelta un archivo `.toml` como `pyproject.toml` o `Cargo.toml`. La herramienta analiza el contenido como TOML, no como INI/JSON genérico.

2

2. Elige Configuración de Sangría y Ajuste

⚙️ Usa el control deslizante **Tamaño de Sangría** para elegir cuántos espacios por nivel de sangría, y cambia **Estilo de Sangría** a tabulaciones si tu proyecto las prefiere. Ajusta **Ajuste / Longitud de Línea** para controlar cuándo deben ajustarse arrays largos o tablas en línea (o establécelo en `0` para desactivar efectivamente el ajuste).

3

3. Haz Clic en "Formatear"

🚀 Pulsa el botón **Formatear**. El formateador reorganizará los arrays, limpiará el espaciado alrededor de `=` y comas, normalizará el espaciado de tablas y aplicará saltos de línea consistentes mientras preserva tus datos.

4

4. Revisa, Copia o Guarda

🔍 Compara el TOML original y el formateado. Cuando estés satisfecho, copia el resultado de vuelta a tu editor o guárdalo como un nuevo archivo `.toml` en tu proyecto.

Especificaciones Técnicas

Características TOML Compatibles

El formateador está construido para configuraciones de proyectos del mundo real y comprende construcciones TOML modernas.

CaracterísticaCompatibilidadEjemplos / Notas
Tablas y subtablas✅ Completa[tool.poetry], [project], [database.replica]
Arrays✅ CompletaArrays en línea y arrays de tablas
Tablas en línea✅ Completoservers = { alpha = "10.0.0.1", beta = "10.0.0.2" }
Fechas y horas✅ Completo2025-09-23T10:20:30Z y formatos de fecha local
Comentarios✅ Conservados# los comentarios permanecen cerca de las configuraciones que describen
Cadenas multilínea✅ CompletoCadenas TOML entre comillas triples para bloques de texto largos

Opciones de Formato (Mapeadas a Controles de Herramienta)

Estas opciones se exponen directamente en la interfaz de usuario y se conectan al complemento subyacente de Prettier para TOML:

OpciónControl de UIRango / ValoresPor defecto
Tamaño de sangríaControl deslizante de Tamaño de Sangría1–8 espacios2 espacios
Estilo de sangríaSelector de Estilo de SangríaEspacios / TabulacionesEspacios
Longitud de líneaAjuste / Longitud de Línea0–120 columnas (0 = efectivamente sin ajuste)80 columnas
Fin de líneaFin de línea (internamente)LF / CRLFLF en salida del navegador

Entrada y Límites

La herramienta está optimizada para archivos TOML pequeños y medianos comúnmente encontrados en repositorios de aplicaciones.

ParámetroValor / ComportamientoNotas
Extensiones de archivo.tomlCualquier archivo de configuración basado en TOML
Tipos MIMEapplication/toml, text/x-tomlUtilizado para la detección de archivos en la zona de soltar
Tamaño máximo de archivo~5 MBLos archivos más grandes pueden ser más lentos y es mejor manejarlos en CI
Máximo de caracteres≈ 2,000,000Límite estricto en el tiempo de ejecución del formateador para evitar bloqueos del navegador

Validación y Manejo de Errores

Si tu archivo no es TOML válido (por ejemplo, falta `=` o comillas no coincidentes), el formateador normalmente devolverá un error legible en lugar de una salida formateada. Corrige la línea indicada y ejecuta el formateador nuevamente.

Alternativas de Línea de Comando para Formateo TOML

¿Te encanta el resultado y quieres el mismo estilo en CI o hooks de pre-commit? Aquí tienes opciones aptas para CLI:

Multiplataforma (Node.js / Prettier)

Instalar Prettier y el plugin TOML

npm install --save-dev prettier prettier-plugin-toml

Añade Prettier y el analizador TOML a tu proyecto.

Formatear un archivo TOML con Prettier

npx prettier --parser toml --write pyproject.toml

Reescribe `pyproject.toml` en el lugar usando las reglas TOML de Prettier.

Linux / macOS / Windows (Taplo CLI)

Formatear TOML usando Taplo

taplo fmt pyproject.toml

Otro formateador CLI popular para archivos TOML.

Verificar formato en CI

taplo fmt --check .

Falla la compilación si los archivos TOML no están correctamente formateados.

Usa esta herramienta en línea para ediciones rápidas y experimentos, luego aplica el mismo estilo con Prettier o Taplo en tus pipelines de CI.

Casos de Uso Comunes del Formateador TOML

Empaquetado Python (`pyproject.toml`)

Mantén los metadatos del proyecto Python y la configuración de herramientas limpios y fáciles de revisar.

  • Alinear secciones `[project]`, `[tool.poetry]` y `[tool.black]`.
  • Normalizar arrays de dependencias y especificadores de versión.
  • Hacer que los diffs de configuración sean más fáciles de leer en las pull requests.
[project]
name = "my-app"
version = "0.1.0"

[tool.black]
line-length = 88
include = "\.(py|pyi)$"

Proyectos Rust (`Cargo.toml`)

Organiza los manifiestos de paquetes Rust en espacios de trabajo y microservicios.

  • Mantén `[dependencies]` y `[dev-dependencies]` ordenados y con espaciado consistente.
  • Normaliza las tablas en línea utilizadas para banderas de características complejas.
  • Estandariza el formato en múltiples crates de un espacio de trabajo.
[package]
name = "my-crate"
version = "0.1.0"
edition = "2021"

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

Sitios Estáticos y Herramientas (Hugo, Zola, etc.)

Limpia TOML utilizado para generadores de sitios estáticos y herramientas diversas.

  • Formatea `config.toml` para Hugo u otros generadores de sitios estáticos.
  • Mantén los bloques de configuración multilingüe legibles.
  • Normaliza listas largas como entradas de menú y taxonomías.

❓ Frequently Asked Questions

❓¿Qué es un formateador de TOML?

Un formateador de TOML reestructura automáticamente tus archivos TOML para que sigan un estilo consistente: corrige la sangría, alinea arreglos y tablas en línea, normaliza los espacios alrededor de `=` y comas, y preserva los datos mientras los hace más fáciles de leer y revisar.

📏¿Cómo debo elegir el tamaño y estilo de sangría?

Si tu equipo no tiene preferencia, **2 espacios** es un buen valor predeterminado. Coincide con el estilo ya utilizado en tu repositorio: si los archivos están mayormente sangrados con espacios, sigue usando espacios; si las tabulaciones son el estándar del equipo, cambia el **Estilo de Sangría** a Tabulaciones para que los nuevos cambios se alineen con el código existente.

🧪¿El formateador valida la sintaxis de TOML?

El analizador subyacente rechazará TOML inválido (por ejemplo, falta de `=` o comillas no coincidentes). En ese caso, la herramienta muestra un mensaje de error en lugar de la salida formateada, para que puedas corregir el problema e intentarlo de nuevo.

🔁¿Puede la ejecución del formateador cambiar el comportamiento de mi configuración?

El formateador está diseñado para ser **preservador de semántica**: solo cambia espacios en blanco y diseño, no claves, valores o estructura de tablas. Siempre que el archivo original sea TOML válido, el significado de tu configuración debería permanecer igual.

🔒¿Es seguro formatear archivos de configuración sensibles?

Como con cualquier herramienta en línea, evita pegar material extremadamente sensible como secretos de producción. Para configuraciones altamente confidenciales, utiliza un formateador de TOML local (como Prettier o Taplo) dentro de tu entorno de desarrollo privado.

Pro Tips

Best Practice

Mantén un `pyproject.toml` o `Cargo.toml` bien formateado en tu rama principal, luego aplica el mismo estilo en CI usando Prettier o Taplo.

Best Practice

Formatea TOML antes de confirmar grandes cambios de dependencias o configuración para que tus diferencias en Git se centren en **cambios reales**, no en ruido de espacios en blanco.

Best Practice

Al refactorizar configuraciones, formatea el archivo primero, confirma, luego cambia los valores. Esto facilita revisar lo que realmente cambió.

Best Practice

Utiliza el mismo **tamaño de sangría** y **longitud de ajuste** en todos tus archivos TOML para que la navegación entre proyectos y las revisiones de código sean consistentes.

Additional Resources

Especificación TOML v1.0.0
Documentation
Plugin Prettier para TOML
Documentation
Taplo – Kit de Herramientas TOML
Documentation

Other Tools