Repolode
shuding

shuding/nextra

MDX와 Markdown 파일로 문서 및 콘텐츠 사이트를 만드는 Next.js 기반 프레임워크입니다.

스타
13,941
포크
1,412
열린 이슈
329
마지막 커밋
3개월 전

어떤 프로젝트인가요?

Nextra는 Next.js 기반의 정적 사이트 생성 프레임워크입니다. MDX나 Markdown으로 페이지를 작성해 웹사이트로 만들 수 있으며, 익숙한 Next.js 라우팅과 React 컴포넌트, 빌드 도구를 그대로 활용합니다.

프로젝트는 두 개의 패키지로 제공됩니다. 콘텐츠 처리를 담당하는 핵심 `nextra` 패키지와 문서 테마인 `nextra-theme-docs`입니다. 저장소에는 예제와 문서 사이트도 포함되어 있으며, Turborepo로 관리하는 PNPM 워크스페이스로 개발됩니다.

Next.js를 기반으로 하므로 Markdown 콘텐츠 안에 React 컴포넌트를 직접 넣을 수 있고, 일반적인 Next.js 앱과 동일한 배포 옵션을 사용할 수 있습니다.

핵심 기능

  • 01React 컴포넌트를 포함해 MDX 또는 Markdown으로 페이지를 작성할 수 있습니다.
  • 02Next.js 라우팅과 빌드 도구를 기반으로 합니다.
  • 03문서 테마 패키지인 nextra-theme-docs를 제공합니다.
  • 04PNPM 워크스페이스와 Turborepo를 사용하는 모노레포 구조입니다.

활용 사례

  • 제품이나 프로젝트의 문서 사이트 구축.
  • Markdown 파일을 활용한 기술 블로그 또는 지식 베이스 운영.
  • 글과 React 컴포넌트를 결합한 인터랙티브 문서 제작.

빠른 시작

  1. 1

    Corepack 활성화

    corepack enable
  2. 2

    프로젝트 종속성 설치

    pnpm install
  3. 3

    예제 문서 사이트를 개발 모드로 시작

    pnpm --filter example-docs dev

사용 전 알아둘 점

  • 개발 환경을 설정하려면 pnpm과 Corepack이 필요하므로, 간편하게 사용하려는 최종 사용자보다는 기여자를 위한 설정입니다.
  • 프레임워크 사용법에 관한 문서는 외부 사이트인 nextra.site에서 제공됩니다.

토픽

자주 묻는 질문

nextra은(는) 무엇인가요?
MDX와 Markdown 파일로 문서 및 콘텐츠 사이트를 만드는 Next.js 기반 프레임워크입니다. Nextra는 Next.js 기반의 정적 사이트 생성 프레임워크입니다. MDX나 Markdown으로 페이지를 작성해 웹사이트로 만들 수 있으며, 익숙한 Next.js 라우팅과 React 컴포넌트, 빌드 도구를 그대로 활용합니다.
nextra은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
nextra은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
nextra은(는) 아직 유지보수되고 있나요?
6개월 이내 업데이트. nextra의 마지막 커밋은 2026년 7월 31일입니다.
nextra은(는) 어디에 사용할 수 있나요?
제품이나 프로젝트의 문서 사이트 구축. Markdown 파일을 활용한 기술 블로그 또는 지식 베이스 운영. 글과 React 컴포넌트를 결합한 인터랙티브 문서 제작.
nextra는 어떻게 설치하나요?
Corepack 활성화: corepack enable 프로젝트 종속성 설치: pnpm install 예제 문서 사이트를 개발 모드로 시작: pnpm --filter example-docs dev
nextra은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/shuding/nextra

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트