Repolode
sdorra

sdorra/content-collections

Herramienta de TypeScript que convierte archivos locales Markdown, MDX, JSON y YAML en colecciones de datos con tipos seguros para aplicaciones web.

Estrellas
1,203
Forks
53
Issues abiertos
54
Último commit
hace 21 horas

¿Qué es?

Content Collections carga archivos de un directorio y los convierte en colecciones de datos tipadas que la aplicación puede importar directamente. En lugar de escribir código para obtener y analizar archivos de contenido, defines colecciones en un archivo de configuración con un esquema; el contenido se analiza y valida durante la compilación.

El esquema valida cada entrada, por lo que los campos incorrectos o ausentes se detectan durante la compilación. Las entradas se pueden transformar antes de que lleguen a la aplicación, por ejemplo, para renderizar Markdown, combinar colecciones u obtener datos de un servidor. Durante el desarrollo, los cambios en el contenido actualizan las colecciones sin reiniciar el servidor ni actualizar el navegador.

Hay adaptadores para Next.js, Remix (Vite), SvelteKit, Solid Start, Qwik y Vite, y una CLI para otros frameworks.

Funciones clave

  • 01Define colecciones tipadas desde un archivo de configuración con un esquema.
  • 02Valida el contenido durante la compilación para detectar errores cuanto antes.
  • 03Actualiza automáticamente las colecciones cuando cambia el contenido durante el desarrollo.
  • 04Permite transformar las entradas antes de que lleguen a la aplicación.
  • 05Ofrece adaptadores para varios frameworks y una CLI para los demás.

Casos de uso

  • Crear un blog o sitio de documentación a partir de archivos Markdown o MDX en un proyecto de Next.js o SvelteKit.
  • Cargar datos estructurados en YAML o JSON como objetos tipados en una aplicación de Vite.
  • Validar un directorio de contenido para que las entradas mal formadas provoquen un error de compilación.

Inicio rápido

  1. 1

    Elige un adaptador para tu framework y sigue la guía de instalación enlazada en el README

  2. 2

    Crea un archivo content-collections.ts en la raíz del proyecto y define tus colecciones

  3. 3

    Escribe contenido Markdown en el directorio de tu colección y luego importa la colección generada en tu aplicación

En colecciones

Temas

Preguntas frecuentes

¿Qué es content-collections?
Herramienta de TypeScript que convierte archivos locales Markdown, MDX, JSON y YAML en colecciones de datos con tipos seguros para aplicaciones web. Content Collections carga archivos de un directorio y los convierte en colecciones de datos tipadas que la aplicación puede importar directamente. En lugar de escribir código para obtener y analizar archivos de contenido, defines colecciones en un archivo de configuración con un esquema; el contenido se analiza y valida durante la compilación.
¿content-collections es gratuito? ¿Qué licencia tiene?
content-collections es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿content-collections sigue mantenido?
Mantenimiento activo. El último commit de content-collections fue el 6 nov 2026.
¿Para qué puedo usar content-collections?
Crear un blog o sitio de documentación a partir de archivos Markdown o MDX en un proyecto de Next.js o SvelteKit. Cargar datos estructurados en YAML o JSON como objetos tipados en una aplicación de Vite. Validar un directorio de contenido para que las entradas mal formadas provoquen un error de compilación.
¿Cómo se instala content-collections?
Elige un adaptador para tu framework y sigue la guía de instalación enlazada en el README Crea un archivo content-collections.ts en la raíz del proyecto y define tus colecciones Escribe contenido Markdown en el directorio de tu colección y luego importa la colección generada en tu aplicación
¿Dónde consigo content-collections?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/sdorra/content-collections

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados