Git Hooks y Husky: bloquear los commits sin Frontmatter MDX válido
Publicado el 25 de octubre de 2026 por David
Acabo de desplegar 5 nuevos artículos en mi blog Next.js. El contenido es preciso, el enfoque es acertado. Sin embargo, 48 horas después, la Google Search Console se vuelve loca. ¿Por qué? Porque un colaborador olvidó la etiqueta description en el Frontmatter de un archivo .mdx. O peor, escribió titre en lugar de title.
Resultado: una etiqueta title vacía, un CTR en caída libre en los resultados de búsqueda y, a veces, incluso un crash del componente en el lado del cliente por un campo de fecha faltante. Todo por un error evitable.
El problema: Confiar en la memoria humana para el SEO técnico es como jugar a la ruleta rusa con tu tráfico orgánico. Las guías en Notion acumulan polvo. La única solución radical para proteger tu adquisición de clientes es la restricción: bloquear el error antes de que salga del ordenador de tu equipo.
El pre-commit hook: tu salvaguarda SEO
En B2B, el tráfico orgánico depende de una ejecución técnica impecable. Así como el SEO de tus documentos PDF determina la supervivencia de tus publicaciones en redes sociales, la estructura de tus archivos MDX define tu indexación en Google. Un .mdx mal formateado significa una etiqueta title vacía, un CTR bajo y, en ocasiones, un componente que falla en el lado del cliente.
La solución: Husky. Esta herramienta te permite aprovechar los Git Hooks sin complicaciones. Al combinar Husky con un control en la fase de pre-commit, impides físicamente el registro de un artículo que viole tus reglas SEO. La terminal parpadea en rojo, el commit es rechazado y el redactor corrige su trabajo en 30 segundos.
Bloquear tu proyecto en 20 minutos
Configurar un script que extraiga y analice el encabezado de tus artículos al momento del commit es cuestión de 20 minutos. La herramienta escanea los archivos modificados y verifica la presencia de los campos obligatorios: título, extracto, fecha e imagen de portada.
Incluso puedes ir más allá con una validación estricta de la longitud. Si la meta descripción supera los 160 caracteres, el script lo corta de raíz. El commit falla al instante. Ahora, aunque un desarrollador freelance temporal en tu proyecto olvide una etiqueta, el archivo corrupto no pasará a producción.
La automatización técnica debe servir a la ejecución visual
He asegurado la estructura textual de mi blog. Directo, pragmático, implacable.
Pero el contenido B2B no vive solo en mis archivos markdown. Para atraer leads cualificados y dominar LinkedIn, necesito elementos visuales. Si protejo mi tiempo con scripts en el código, no voy a desperdiciarlo moviendo manualmente bloques de texto en Figma durante 3 horas. Mi proceso creativo requiere la misma rigurosidad que mi Git.
Les illustrations de ce blog sont généreusement mises à disposition par les photographes d' Unsplash.