CMS basado en Markdown: qué es, ventajas y cuándo conviene

Durante años, «gestionar contenido» significó una cosa: una base de datos, un panel pesado y un servidor que había que cuidar. Pero hay una corriente que le da la vuelta a esa idea. ¿Y si tu contenido no viviera en una base de datos, sino en simples archivos de texto dentro del mismo repositorio donde está tu código?

Eso es, en una frase, un CMS basado en Markdown. Suena a algo solo para programadores, pero detrás hay una decisión de arquitectura con consecuencias muy concretas en rendimiento, coste y mantenimiento. Vale la pena entender cuándo es la mejor opción y cuándo no.

Qué es un CMS basado en Markdown

Markdown es un formato de texto plano que se escribe de forma natural y se convierte en HTML. Un CMS basado en Markdown guarda cada entrada como un archivo (normalmente .md o .mdx), con unos metadatos al inicio (título, fecha, autor) y el cuerpo debajo. Así se ve un archivo de contenido por dentro:

---
title: Mi primer post
date: 2026-07-04
---

# Hola mundo

Este contenido vive en un archivo .md de tu repositorio.

Como cada entrada es un archivo dentro de tu repositorio, entra en juego algo poderoso: Git. El historial de cambios, las ramas y la revisión por pull request que ya usas para el código pasan a aplicar también al contenido. Por eso a este enfoque se le llama también «CMS basado en Git».

Markdown, Git y «headless»: cómo encajan

Un CMS basado en Markdown es, por definición, headless: separa el contenido de la presentación. Tú guardas los archivos y un generador de sitios (como Next.js o Astro) los lee y arma el HTML final. La diferencia con un headless clásico como Directus o Strapi es dónde vive el contenido: allí sigue habiendo una base de datos y una API; aquí, solo archivos en tu repo.

Ventajas

• El contenido son archivos de texto en tu repositorio: no hay base de datos que mantener ni respaldar aparte.
• Control de versiones nativo con Git: historial completo, ramas y revisión por pull request antes de publicar.
• Rinde y posiciona: encaja con generadores estáticos, así que el sitio final es rápido y con buen SEO técnico.
• Barato de alojar y desplegar (Vercel, Netlify) y con muy poca superficie de ataque.
• El contenido es tuyo y portable: si mañana cambias de herramienta, te llevas tus .md sin migraciones raras.

Desventajas

• No está pensado para miles de entradas ni para muchas personas editando a la vez.
• Publicar suele implicar un despliegue (build); no es tan inmediato como guardar en una base de datos.
• Ecosistema más joven que WordPress: menos plugins e integraciones listas para usar.
• Funciones como internacionalización, roles y permisos son más limitadas que en un CMS grande.
• El montaje inicial pide manejar Git y despliegues, aunque quien edite después no necesita saber nada de eso.

CMS basado en Markdown vs CMS tradicional

Para qué tipo de proyecto (y cliente) conviene

Encaja de maravilla cuando el contenido es importante pero no gigantesco: sitios de marketing, landing pages, blogs, portafolios y documentación de producto. Es la opción natural para equipos que ya trabajan con Next.js o Astro y despliegan en Vercel o Netlify, y para clientes que valoran un sitio rápido, seguro y con poco mantenimiento, siendo dueños de su contenido.

No es la herramienta si tu proyecto es un medio con miles de artículos y una redacción numerosa editando en paralelo (ahí pesan más WordPress o un CMS de medios), ni para un e-commerce complejo o contenido que cambia en tiempo real.

La herramienta que mejor representa hoy esta idea es Keystatic: open source, con un panel de edición amigable montado sobre tus archivos y Git. En las siguientes guías lo instalamos paso a paso, primero en Next.js y después en Astro.

Tres preguntas antes de elegir

Para decidir entre Markdown y un CMS con base de datos bastan tres preguntas. ¿Cuántas personas editarán y qué tan técnicas son? ¿Cuántas entradas tendrás dentro de dos años? ¿Necesitas que publicar sea inmediato o aceptas esperar un despliegue?

Si la respuesta es «pocas, cientos y puedo esperar», Markdown suele ganar: menos piezas que se rompan y contenido que sigue siendo tuyo. Si cualquiera de las tres cambia (muchos editores, miles de entradas, publicación al instante), la balanza se mueve hacia un CMS con base de datos, y no pasa nada: es mejor elegirlo de entrada que migrar a presión.

Lo que no conviene es decidir por moda. Un buen CMS es el que tu equipo de verdad va a usar un martes cualquiera.

¿Estás decidiendo cómo gestionar el contenido de tu próximo sitio? En Codegea ayudamos a elegir e implementar el CMS correcto para cada caso. Mira el servicio de integración de CMS o escríbenos desde la página de contacto.