Usa el Formatear y Validar TOML gratuito abajo: tus datos nunca salen de tu navegador, todo el trabajo ocurre en tu dispositivo y no se sube a ningún servidor.
Por qué los archivos TOML se desordenan
Los archivos TOML empiezan limpios y se desordenan con el tiempo. Un desarrollador escribe las claves con espacios alrededor del signo igual, otro las escribe sin espacios. Alguien pega una sección de otro proyecto con otra sangrÃa. Un encabezado de tabla queda lejos de sus claves después de varias ediciones. Nada de esto rompe el archivo, porque TOML ignora la mayorÃa de los espacios en blanco, pero hace que el archivo sea más difÃcil de leer, y en las configuraciones difÃciles de leer es donde se esconden los errores. Un formateador devuelve un diseño único y coherente, y un validador demuestra que el archivo es realmente correcto.
La validación importa más que el formato. Un corchete de cierre que falta en un encabezado de tabla, una clave duplicada o un valor con el tipo equivocado harán que un programa rechace todo el archivo, muchas veces con un mensaje de error que apunta a la lÃnea equivocada. Revisar el archivo aquÃ, antes de guardarlo en tu proyecto, detecta esos errores cuando todavÃa son baratos de corregir.
Cómo usar la herramienta
Pega tu TOML en el cuadro de entrada. Pulsa Solo validar si solo quieres un veredicto: la herramienta dice si es válido, con un recuento de las claves encontradas, o no válido, con el primer mensaje de error. Pulsa Formatear TOML si quieres la versión limpia en el cuadro de salida, lista para copiar de nuevo a tu proyecto. El resultado formateado usa el diseño estándar de la biblioteca smol-toml: una clave por lÃnea, una lÃnea en blanco antes de cada encabezado de tabla, y valores escritos en su forma canónica.
Formatear nunca cambia lo que significa tu configuración. Solo cambia su aspecto. Las claves mantienen el mismo orden dentro de cada tabla, los valores mantienen sus tipos, y las tablas anidadas mantienen su estructura. Si formatear cambiara alguna vez un valor, eso serÃa un error, asà que compara el primer resultado formateado con tu original y confirma que los ajustes coinciden antes de adoptar el hábito.
Errores comunes de TOML que detecta el validador
Las claves duplicadas son el error más común. TOML prohÃbe definir la misma clave dos veces en una tabla, y también prohÃbe definir una tabla dos veces. Un bloque pegado suele duplicar una clave que ya existe más arriba, y el validador lo señala de inmediato. Los corchetes sin cerrar son lo siguiente: un encabezado como [servidor sin su corchete de cierre es fácil de pasar por alto en un archivo largo. Los valores incorrectos son lo tercero: una fecha escrita con la forma equivocada, un texto con una comilla sin escapar, o un número con dos puntos decimales fallan al analizarse.
El mensaje de error te dice qué salió mal, y normalmente dónde. Léelo al pie de la letra. Si dice que una clave ya está definida, busca esa clave en el archivo. Si se queja de un carácter inesperado, mira la lÃnea que nombra. Corrige un error cada vez y vuelve a validar, porque el primer error puede esconder los siguientes, y corregir en orden es más rápido que adivinar.
Mantener ordenados los archivos de configuración en equipo
Acuerda un solo diseño y formatea cada configuración antes de subirla. Cuando todos los archivos se ven igual, la revisión de código es más rápida, porque quien revisa ve cambios reales en lugar de ruido de espacios en blanco. Incorpora el formateo a tu rutina igual que ya haces con el código fuente: formatea al guardar, o formatea antes de subir. El hábito cuesta segundos y evita la deriva lenta que convierte una configuración ordenada en un rompecabezas.
También adquiere el hábito de validar archivos que no escribiste tú. Las configuraciones copiadas de artÃculos, generadas por scripts o fusionadas desde otra rama son las que más probablemente traen un error sutil. Una revisión de treinta segundos aquà vale más que una hora depurando un servicio que se niega a arrancar por una sola lÃnea mala.
Preguntas frecuentes
¿Formatear cambia mis valores? No. Solo reescribe el diseño y los espacios. Los valores, las claves y la estructura se mantienen.
¿Y si mi TOML es válido pero feo? Para eso está Formatear. Válido y feo se convierte en válido y legible.
¿El validador revisa el archivo contra un esquema? No. Revisa solo la sintaxis: si el TOML está bien formado. No puede saber si tu aplicación exige una clave concreta.
Pega tu TOML arriba, valÃdalo, formatéalo, y sube una configuración que puedas leer con confianza.