Repolode
shuding

shuding/nextra

Um framework baseado em Next.js para criar sites de documentação e conteúdo a partir de arquivos MDX e Markdown.

Estrelas
13,941
Forks
1,412
Issues abertas
329
Último commit
há 3 meses

O que é?

Nextra é um framework de geração de sites estáticos baseado em Next.js. Ele permite escrever páginas em MDX ou Markdown e transformá-las em um site, mantendo o roteamento familiar do Next.js, os componentes React e as ferramentas de build.

O projeto é distribuído em dois pacotes: o pacote principal `nextra`, responsável pelo processamento de conteúdo, e `nextra-theme-docs`, um tema para documentação. O repositório também inclui exemplos e um site de documentação, e o desenvolvimento acontece em um workspace PNPM gerenciado com Turborepo.

Por ser baseado em Next.js, você pode incorporar componentes React diretamente ao conteúdo Markdown e usar as mesmas opções de implantação de qualquer app Next.js.

Recursos principais

  • 01Escreva páginas em MDX ou Markdown com componentes React incorporados.
  • 02Baseado no roteamento e nas ferramentas de build do Next.js.
  • 03Oferece um pacote de tema para documentação, nextra-theme-docs.
  • 04Estrutura de monorepo com workspaces PNPM e Turborepo.

Casos de uso

  • Criar um site de documentação para um produto ou projeto.
  • Publicar um blog técnico ou uma base de conhecimento a partir de arquivos Markdown.
  • Criar documentação interativa que combine texto com componentes React.

Início rápido

  1. 1

    Ativar o Corepack

    corepack enable
  2. 2

    Instalar as dependências do projeto

    pnpm install
  3. 3

    Iniciar o site de documentação de exemplo no modo de desenvolvimento

    pnpm --filter example-docs dev

Antes de usar

  • A configuração do ambiente de desenvolvimento requer pnpm e Corepack, por isso é voltada a quem contribui com o projeto, não a usuários finais que buscam uma solução rápida.
  • A documentação sobre como usar o framework está hospedada externamente em nextra.site.

Tópicos

Perguntas frequentes

O que é nextra?
Um framework baseado em Next.js para criar sites de documentação e conteúdo a partir de arquivos MDX e Markdown. Nextra é um framework de geração de sites estáticos baseado em Next.js. Ele permite escrever páginas em MDX ou Markdown e transformá-las em um site, mantendo o roteamento familiar do Next.js, os componentes React e as ferramentas de build.
nextra é gratuito? Qual é a licença?
nextra é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
nextra ainda é mantido?
Atualizado nos últimos 6 meses. O último commit de nextra foi em 31 de jul. de 2026.
Para que posso usar nextra?
Criar um site de documentação para um produto ou projeto. Publicar um blog técnico ou uma base de conhecimento a partir de arquivos Markdown. Criar documentação interativa que combine texto com componentes React.
Como instalar nextra?
Ativar o Corepack: corepack enable Instalar as dependências do projeto: pnpm install Iniciar o site de documentação de exemplo no modo de desenvolvimento: pnpm --filter example-docs dev
Onde consigo nextra?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/shuding/nextra

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados