Nextra — это open-source фреймворк для сайтов документации и блогов на Next.js: вы пишете страницы в Markdown и MDX, а Nextra собирает из них сайт с навигацией, поиском и тёмной темой.
Главное отличие — минимум настройки. Структура папок сразу становится меню, а готовая тема документации выглядит аккуратно без дизайнера.
Возможности
- MDX: Markdown с React-компонентами внутри страниц.
- Тема документации с боковым меню, оглавлением, переключателем темы.
- Поиск по сайту без внешних сервисов.
- Подсветка кода, вкладки, плашки, схемы.
- Мультиязычность и статическая сборка.
- Тема блога для простых сайтов со статьями.
Кому подходит
Разработчикам и командам, которые ведут документацию к библиотеке, API или продукту и уже работают с Next.js.
Как начать
Создайте проект Next.js, установите Nextra и тему документации, добавьте папку с MDX-страницами. Разместите сайт на Vercel или любом статическом хостинге.
Совет
Держите документацию в одном репозитории с кодом: правки в API и в документации попадут в один пулл-реквест и не разъедутся.
Ограничения
Нет визуального редактора — править страницы удобно только тем, кто работает с Git. Для команды без разработчиков проще GitBook или Mintlify. Если нужна гибкость и больше компонентов, посмотрите Fumadocs, для крупных проектов — Docusaurus.