Contentlayer — библиотека с открытым кодом, которая превращает Markdown и MDX-файлы в типизированные JSON-данные для сайта на Next.js и других фреймворках.
Главное отличие — контент живёт в репозитории как обычные файлы, а Contentlayer проверяет их по схеме и генерирует типы TypeScript. Ошибка в поле статьи всплывает на этапе сборки, а не на живом сайте.
Возможности
- Схема документов — поля, типы и обязательность для статей, страниц, авторов.
- Типы TypeScript — автоматическая генерация типов по схеме.
- MDX — компиляция MDX с плагинами remark и rehype.
- Вычисляемые поля — slug, время чтения, оглавление.
- Горячая перезагрузка — правка Markdown сразу видна в режиме разработки.
Кому подходит
Разработчикам блогов, документации и сайтов-портфолио, которые хранят тексты в Git и не хотят отдельную CMS.
Как начать
Установите пакет, опишите схему документа в contentlayer.config.ts и подключите плагин к конфигурации Next.js. Импортируйте сгенерированные данные на страницах.
Совет
Для нового проекта сначала посмотрите на Velite: он решает ту же задачу и развивается. Contentlayer оставьте для поддержки старых проектов.
Ограничения
Основная разработка остановилась в 2023 году, после ухода спонсора. Новые версии Next.js поддерживаются только через неофициальный форк contentlayer2. Если нужен визуальный редактор для авторов, берите Keystatic или TinaCMS.