Repolode
Предложить
shuding

shuding/nextra

Фреймворк на базе Next.js для создания документации и контентных сайтов из файлов MDX и Markdown.

Открыть на GitHubСайт
Звёзды
13,941
Форки
1,412
Открытые issues
329
Последний коммит
3 месяца назад

Что это?

Nextra — фреймворк статической генерации сайтов на базе Next.js. Он позволяет писать страницы на MDX или Markdown и превращать их в сайт, сохраняя привычную маршрутизацию Next.js, React-компоненты и инструменты сборки.

Проект состоит из двух пакетов: основного `nextra`, который обрабатывает контент, и `nextra-theme-docs` — темы для документации. В репозитории также есть примеры и сайт документации. Разработка ведётся в рабочем пространстве PNPM под управлением Turborepo.

Поскольку Nextra построен на Next.js, в контент Markdown можно встраивать React-компоненты и использовать те же варианты развёртывания, что и для любого приложения Next.js.

Ключевые возможности

  • 01Пишите страницы на MDX или Markdown и встраивайте в них React-компоненты.
  • 02Использует маршрутизацию и инструменты сборки Next.js.
  • 03Предоставляет пакет темы для документации `nextra-theme-docs`.
  • 04Структура монорепозитория на базе рабочих пространств PNPM и Turborepo.

Сценарии использования

  • Создание сайта с документацией продукта или проекта.
  • Публикация технического блога или базы знаний из файлов Markdown.
  • Создание интерактивной документации, сочетающей текст и React-компоненты.

Быстрый старт

  1. 1

    Включить Corepack

    corepack enable
  2. 2

    Установить зависимости проекта

    pnpm install
  3. 3

    Запустить демонстрационный сайт документации в режиме разработки

    pnpm --filter example-docs dev

Что важно знать

  • Для настройки среды разработки требуются pnpm и Corepack, поэтому она рассчитана на участников проекта, а не на конечных пользователей, которым нужно быстро начать работу.
  • Документация по использованию фреймворка размещена на внешнем сайте nextra.site.

Темы

#markdown#mdx#nextjs#react#static-site-generator#documentation#nextra

Частые вопросы

Что такое nextra?
Фреймворк на базе Next.js для создания документации и контентных сайтов из файлов MDX и Markdown. Nextra — фреймворк статической генерации сайтов на базе Next.js. Он позволяет писать страницы на MDX или Markdown и превращать их в сайт, сохраняя привычную маршрутизацию Next.js, React-компоненты и инструменты сборки.
nextra можно использовать бесплатно? Какая у него лицензия?
nextra распространяется с открытым исходным кодом под лицензией MIT. Перед использованием в коммерческих продуктах проверьте условия лицензии.
nextra всё ещё поддерживается?
Обновлялся за последние 6 месяцев. Последний коммит в nextra — 31 июл. 2026 г..
Для чего можно использовать nextra?
Создание сайта с документацией продукта или проекта. Публикация технического блога или базы знаний из файлов Markdown. Создание интерактивной документации, сочетающей текст и React-компоненты.
Как установить nextra?
Включить Corepack: corepack enable Установить зависимости проекта: pnpm install Запустить демонстрационный сайт документации в режиме разработки: pnpm --filter example-docs dev
Где скачать nextra?
Исходный код и инструкции по установке — на GitHub: https://github.com/shuding/nextra

Описание создано ИИ на основе README проекта. Статистика GitHub обновляется ежедневно.

Похожие проекты