Content Collections y Markdown en Valencia: contenido editorial sin base de datos

El contenido editorial necesita estructura, no una base de datos

Las empresas de Valencia —tecnológicas, ecommerce, turismo, educación— generan contenido editorial para posicionar, educar a sus clientes y demostrar autoridad. Blog, guías, casos de éxito, descargables. Todo ese contenido necesita organización, pero no necesariamente una base de datos.

WordPress almacena el contenido en MySQL y lo sirve con PHP. Cada visita ejecuta consultas. Con Astro, el contenido editorial se organiza en Content Collections: archivos Markdown con esquemas definidos que se convierten en páginas HTML durante el build.

Content Collections: colecciones con esquema

Astro permite definir colecciones de contenido con un esquema (schema) que valida los datos. Esto significa que cada archivo Markdown en una colección debe cumplir con los campos esperados.

Ejemplo de colección “blog”:

• title: string, obligatorio.
• date: fecha, obligatorio.
• tags: array de strings, opcional.
• author: string, obligatorio.
• description: string, obligatorio para SEO.
• image: string, opcional.
• draft: booleano, para borradores.

Si alguien crea un artículo sin título, Astro lanza un error en el build. Esto evita contenido incompleto publicado por error.

Más allá del blog: colecciones para cada tipo de contenido

En una web corporativa en Valencia, las Content Collections pueden organizar:

Servicios. Cada servicio tiene título, descripción corta, descripción ampliada, icono, preguntas frecuentes asociadas y enlace a casos de éxito. La página de listado de servicios y las páginas individuales se generan automáticamente.

Casos de éxito. Cliente, sector, problema, solución, resultados (con datos cuantitativos), tecnologías usadas y testimonio.

Equipo. Nombre, cargo, bio, foto, redes sociales.

Testimonios. Cliente, cargo, empresa, texto del testimonio, valoración (estrellas).

Páginas legales. Aviso legal, privacidad, cookies. Contenido estático con versionado.

Flujo de trabajo editorial con Markdown

El flujo típico en una empresa de Valencia con Astro:

1. El redactor crea un archivo Markdown siguiendo la plantilla de la colección.
2. El archivo se sube al repositorio (Git).
3. Se abre un pull request para revisión.
4. Al fusionar, el build genera la página y se despliega.

Para equipos no técnicos, se añade una interfaz: Decap CMS, TinaCMS o Sanity. El equipo escribe en un panel visual y el CMS traduce eso a archivos Markdown en el repositorio. El resultado es el mismo: HTML estático en producción.

Paginación, taxonomías y búsqueda sin base de datos

Astro permite generar páginas dinámicamente a partir de colecciones sin servidor:

• Paginación: si el blog tiene 50 artículos, Astro genera páginas /blog/1, /blog/2, etc., cada una con su HTML completo.
• Categorías y tags: por cada categoría o tag, se genera una página con los artículos filtrados. Todo en build time.
• Búsqueda: con Pagefind, se genera un índice de búsqueda durante el build. El usuario busca sin llamadas a servidor.

Cuándo las Content Collections no son suficientes

El sistema de archivos Markdown funciona bien cuando:

• El contenido lo edita un equipo pequeño (1-5 personas).
• Los cambios pasan por revisión antes de publicarse.
• El volumen de contenido es moderado (menos de 1000 páginas).
• No necesitas programar publicaciones automáticas.

No funciona bien cuando:

• Decenas de usuarios editan simultáneamente y necesitan bloqueo de edición.
• El contenido debe publicarse en momentos exactos del día (fechas programadas).
• Necesitas un historial completo de versiones con comparación visual.

Para esos casos, un CMS headless dedicado es la solución. Astro sigue siendo el frontend, pero el backend de contenido es una herramienta profesional.

Preguntas frecuentes sobre Content Collections

¿Puedo importar contenido existente de WordPress a Content Collections?

Sí. Exportamos las entradas de WordPress a Markdown mediante herramientas como wordpress-export-to-markdown. Cada entrada se convierte en un archivo con su frontmatter y contenido. Las imágenes se descargan y referencian localmente.

¿Qué editor de Markdown recomiendas para el equipo editorial?

VS Code con preview funciona para equipos técnicos. Para equipos no técnicos, Decap CMS (antes Netlify CMS) ofrece un panel visual limpio que escribe Markdown internamente. También funciona TinaCMS o Forestry (ahora parte de Tina).

¿Se pueden tener imágenes y archivos adjuntos en Content Collections?

Sí. Las imágenes se almacenan en la carpeta de assets del proyecto. Se referencian desde el frontmatter o el cuerpo del Markdown. Astro las optimiza durante el build (WebP, AVIF, tamaños responsivos).

¿Qué ocurre si elimino una colección o cambio su esquema?

Astro validará el nuevo esquema contra los archivos existentes. Si eliminamos un campo obligatorio o añadimos uno nuevo que no existe en archivos anteriores, el build falla hasta que actualicemos los archivos. Es una red de seguridad.

¿Puedo tener contenido multilingüe con Content Collections?

Sí. Se crean colecciones paralelas: blog-es, blog-en. Opcionalmente, se usa un campo "lang" en el frontmatter para filtrar. La navegación entre idiomas se configura desde el layout, usando el slug como identificador común.