Docusaurus
Gerador de sites estáticos de código aberto para documentação, publicado pela Meta
Docusaurus é um gerador de sites estáticos de código aberto da Meta, sob licença MIT, para criar e manter sites de documentação. Um único comando levanta um site em React que já vem com uma seção de documentação versionada, um blog, páginas avulsas e um tema, e o repositório traz plugins mantidos para sitemaps, busca com Algolia, traduções, redirecionamentos e tags de analytics. Tem 65.749 estrelas em julho de 2026. Para quem lança uma ferramenta para desenvolvedores, ele elimina o custo de construir um site de documentação — o que é diferente de alguém chegar para lê-lo.
O que é o Docusaurus
O Docusaurus (github.com/facebook/docusaurus) se descreve como um projeto para criar, publicar e manter com facilidade sites de projetos de código aberto. Na prática é um gerador de sites estáticos baseado em React em que a documentação é cidadã de primeira classe: um comando, npm init docusaurus@latest, produz um site que já tem seção de documentação, blog, páginas avulsas e um tema, então o primeiro dia é gasto escrevendo conteúdo e não montando uma stack. A Meta o publicou porque ele ajuda a escalar entre os muitos projetos de código aberto que mantém. O código está sob licença MIT, e o conteúdo de documentação do repositório carrega uma licença Creative Commons separada.
- Os tipos de conteúdo são plugins separados — o repositório publica pacotes próprios distintos para documentação, para blog e para páginas avulsas, então um site pode ser só documentação, documentação mais um changelog, ou um site completo com página inicial de marketing, sem trazer uma segunda ferramenta.
- As peças que você acrescentaria por fora já estão lá — geração de sitemap, busca com Algolia, redirecionamentos no cliente para as URLs que você mover, traduções, suporte a PWA, diagramas Mermaid, otimização de imagens e tags do Google Analytics existem como pacotes mantidos dentro do mesmo repositório.
- O formato de escrita é MDX — as páginas são Markdown que pode embutir componentes React, o que torna possível um bloco de código executável ou um exemplo interativo dentro de uma página que, no resto, é apenas um arquivo do seu repositório.
Documentação, blog e página de marketing são três trabalhos diferentes
A forma mais comum de desperdiçar um site de documentação é tratá-lo como mais uma superfície de conteúdo e julgar tudo pelo mesmo número. Essas três superfícies atraem pessoas diferentes chegando em estados diferentes, e só uma delas está tentando ser encontrada por alguém que nunca ouviu falar de você.
| Superfície | Quem chega | O que consegue e o que não consegue fazer |
|---|---|---|
| Documentação | Alguém que já usa o produto, ou que confere se ele faz uma coisa específica | Remove dúvida e destrava a configuração. Raramente cria demanda sozinha, mas é onde um talvez vira um sim |
| Blog ou changelog | Alguém buscando um problema, ou um usuário atual vendo o que foi lançado | Pode ganhar visitantes novos e dar aos atuais um motivo para voltar. Precisa de uma razão de existir além das notas de versão |
| Página inicial de marketing | Alguém decidindo se aquilo lhe interessa | Enquadra o produto para estranhos. A documentação não consegue fazer esse trabalho, e quando tenta é lida como manual |
O Docusaurus hospeda as três com prazer, e aí está a armadilha: como saem na mesma build, são avaliadas como uma coisa só. Separe os relatórios antes de separar qualquer outra coisa — uma página de documentação e uma landing page parecem idênticas numa tabela de tráfego enquanto respondem perguntas completamente diferentes. Se a metade editorial é o trabalho de verdade, o Ghost foi feito para isso; se o conteúdo precisa de uma interface de edição para quem não abre pull requests, isso é o Payload.
Onde um site de documentação entra na stack de crescimento
Documentação é o conteúdo de maior intenção que a maioria das ferramentas para desenvolvedores possui, e o mais sistematicamente subinvestido. Ele também posiciona, num tipo específico de busca: desenvolvedores procuram mensagens de erro, nomes de API e de funções, e formulações do tipo como faço tal coisa nesta ferramenta. São buscas de baixa concorrência e alta intenção, e uma resposta precisa vence sem o trabalho que um termo principal disputado exige. É uma superfície de aquisição real, porém estreita, porque quase toda busca dessas já contém o nome do seu produto ou um problema que o seu produto criou. A documentação multiplica o que você já tem em vez de iniciar. Conquistar a atenção primeiro é tratado em como faço marketing de uma ferramenta para desenvolvedores, e ser dono de um assunto em vez de uma página é autoridade tópica.
Nota de primeira mão de quem construiu o AgentCeres — o AI Growth Officer, em agentceres.com: o que não esperávamos é que uma página de documentação e uma de marketing pareçam idênticas num relatório de analytics enquanto fazem trabalhos opostos. Uma é lida por quem está decidindo; a outra, por quem já decidiu e agora travou. Só percebemos porque as perguntas que chegavam ao chat do nosso próprio produto eram, quase linha por linha, os títulos que a nossa documentação deveria ter. Uma thread de suporte acaba sendo um índice melhor do que qualquer ferramenta de palavras-chave, porque é a lista dos pontos exatos em que o produto deixou de ser óbvio, ordenada por quantas vezes as pessoas esbarram neles. Se você instalar o Docusaurus esta semana, a página mais valiosa para escrever primeiro não é o tour de funcionalidades. É a resposta à pergunta que você já digitou à mão três vezes.
FAQ
- O Docusaurus é gratuito?
- O repositório informa que o Docusaurus está sob licença MIT, com o conteúdo de documentação do repo sob uma licença Creative Commons separada. Não há plano pago, porque ele gera arquivos estáticos que você hospeda onde quiser, então o custo é o da hospedagem escolhida — muitas vezes zero para um site estático. Confira os arquivos LICENSE da versão que instalar, já que licenças mudam independentemente de qualquer texto sobre elas.
- Docusaurus ou um framework web de uso geral?
- Se o site é majoritariamente documentação, a ferramenta especializada vence, porque versionamento de docs, barras laterais, busca e uma arquitetura de informação em formato de documentação já estão resolvidos e você estaria refazendo tudo. Se a documentação é uma seção de um site de marketing com exigências fortes de design, normalmente vence um framework geral mais uma camada de conteúdo, porque do contrário você passa o tempo brigando com um tema construído em torno de outro centro de gravidade. A pergunta é para qual das duas coisas o site serve principalmente.
- Sites de documentação realmente ajudam no SEO?
- Podem ajudar, numa classe específica de busca: mensagens de erro, nomes de API e de funções, dúvidas de integração e formulações de como faço que citam a sua ferramenta. São buscas pouco disputadas e de alta intenção, e uma resposta precisa vence sem precisar de muita autoridade de domínio. O que a documentação não consegue é posicionar para os termos amplos de categoria que alcançam quem nunca ouviu falar de você. Esse tráfego precisa ser conquistado em outro lugar.
- Devo ativar o blog embutido?
- Só se for realmente usar. Um changelog é um bom padrão: tem material naturalmente e dá a quem volta um motivo para voltar. Um blog de marketing é um compromisso maior do que parece, e um abandonado com três posts de dezoito meses atrás soa pior do que blog nenhum. Comece pelo changelog e acrescente o blog quando tiver um conjunto específico de perguntas que pretende responder.
You built it. Now grow it.
AgentCeres is a managed AI marketing team — specialists draft the SEO, social, and outreach that fill your links, you approve what ships. 14-day free trial, from $39/month.