Compilado por Pablo Murad - 2026
Ideia geral
MkDocs é uma ferramenta muito boa porque resolve um problema comum com pouca frescura: você escreve em Markdown, organiza a navegação em um arquivo de configuração e gera um site estático bonito, rápido e fácil de hospedar.
A boa notícia é que existe um ecossistema enorme de ferramentas parecidas. A má notícia é que nem todas são boas para o mesmo tipo de projeto. Algumas são melhores para documentação técnica, outras para livros digitais, outras para APIs, outras para blogs, outras para documentação corporativa com colaboração.
Este guia lista alternativas e ferramentas próximas ao MkDocs, com explicação prática de quando usar cada uma.
Como escolher sem se perder
Antes de escolher ferramenta, responda isto:
- Você quer escrever em Markdown puro?
- Precisa de busca interna?
- Precisa de versionamento de documentação?
- Vai hospedar sozinho em Caddy/Nginx?
- Quer algo minimalista ou bonito pronto?
- Precisa de plugins?
- Precisa documentar API automaticamente?
- Quer usar Git como fonte da verdade?
- Precisa de colaboração não técnica?
- Quer publicar em HTML, PDF, ePub ou só site?
Regra direta:
- Quer algo parecido com MkDocs e simples: Retype, VitePress, Docsify.
- Quer documentação bonita e moderna para produto/projeto: Docusaurus, Starlight, Nextra.
- Quer docs técnicas Python/API: Sphinx.
- Quer livro/manual em Markdown: mdBook.
- Quer algo grande, versionado e corporativo: Antora, Docusaurus, GitBook.
- Quer site estático mais geral: Hugo, Eleventy, Zola, Jekyll.
- Quer publicação técnica/acadêmica com código, PDF, HTML e notebooks: Quarto.
1. MkDocs
Site: https://www.mkdocs.org/
O que é
MkDocs é um gerador de site estático voltado especificamente para documentação de projetos. Os arquivos são escritos em Markdown e a configuração fica normalmente em mkdocs.yml.
Por que é legal
- Simples de instalar.
- Simples de configurar.
- Usa Markdown.
- Tem ótimo ecossistema de temas, especialmente Material for MkDocs.
- Gera HTML estático fácil de hospedar.
- Excelente para documentação de software, projetos internos, manuais e bases de conhecimento.
Quando usar
Use quando você quer documentação rápida, limpa e sem complicar com React, Vue ou build moderno de frontend.
Limitação
Para customização muito profunda de interface, ele pode ficar menos flexível do que Docusaurus, VitePress, Starlight ou Nextra.
2. Material for MkDocs
Site: https://squidfunk.github.io/mkdocs-material/
O que é
É o tema/ecossistema mais famoso para MkDocs. Na prática, muita gente fala “MkDocs” querendo dizer “MkDocs com Material”.
Por que é legal
- Visual excelente pronto.
- Busca integrada.
- Navegação lateral boa.
- Abas, admonitions, cards, code blocks bons.
- Suporte a Mermaid, tags, blog, versionamento com plugins e muitos recursos extras.
Quando usar
Se você gostou de MkDocs, provavelmente o caminho natural é dominar Material for MkDocs antes de trocar de ferramenta.
Limitação
Alguns recursos avançados podem depender de configuração, plugins ou versão paga/Insiders do Material.
3. Docusaurus
Site: https://docusaurus.io/
O que é
Docusaurus é um gerador de sites estáticos focado em documentação, criado no ecossistema React. Ele usa Markdown/MDX e gera HTML estático com navegação rápida de aplicação web.
Por que é legal
- Muito bom para documentação de produto e projeto open source.
- Suporta docs, blog e páginas customizadas.
- Usa MDX, então dá para colocar componentes React dentro do conteúdo.
- Bom para versionamento de documentação.
- Tem ecossistema forte.
- Visual profissional.
Quando usar
Use quando você quer uma documentação mais “produto SaaS/open source moderno” e aceita trabalhar com Node/React.
Limitação
É mais pesado e mais complexo do que MkDocs. Para documentação simples, pode ser canhão para matar formiga.
4. VitePress
Site: https://vitepress.dev/
O que é
VitePress é um gerador de sites estáticos baseado em Vite e Vue. Ele transforma Markdown em sites rápidos, com um tema padrão voltado para documentação técnica.
Por que é legal
- Muito rápido.
- Ótimo visual padrão.
- Excelente para documentação técnica.
- Suporta Vue components em Markdown.
- Configuração relativamente simples.
- Menos pesado conceitualmente que Docusaurus.
Quando usar
Use quando você gosta da experiência do MkDocs, mas quer algo no ecossistema Vue/Vite.
Limitação
Se você não quer lidar com Node, npm/pnpm e frontend moderno, MkDocs continua mais direto.
5. VuePress
Site: https://vuepress.vuejs.org/
O que é
VuePress é um gerador estático centrado em Markdown e Vue. Foi criado originalmente para documentação do Vue e seus subprojetos.
Por que é legal
- Markdown como base.
- Permite usar componentes Vue.
- Tem tema padrão e sistema de temas/plugins.
- Serve para documentação, blogs e sites estáticos.
Quando usar
Use se você já está no ecossistema Vue e quer uma documentação customizável.
Limitação
Hoje, para muitos projetos novos, VitePress costuma parecer mais moderno e mais direto.
6. Docsify
Site: https://docsify.js.org/
O que é
Docsify é uma ferramenta de documentação que carrega e renderiza Markdown no navegador. Diferente de MkDocs, ele não gera HTML estático previamente no build tradicional.
Por que é legal
- Não precisa de build.
- Basta um
index.htmle arquivos Markdown. - Muito simples para publicar rapidamente.
- Bom para documentação pequena, notas técnicas e projetos pessoais.
Quando usar
Use quando você quer algo extremamente rápido, quase “joga Markdown numa pasta e publica”.
Limitação
Como ele renderiza no cliente, não é a melhor opção para SEO/performance máxima em sites grandes. Para documentação pública séria, MkDocs, Docusaurus ou VitePress costumam ser escolhas mais sólidas.
7. Sphinx
Site: https://www.sphinx-doc.org/
O que é
Sphinx é um gerador de documentação muito usado no mundo Python. Ele é forte em documentação técnica, documentação de API e geração automática a partir de docstrings.
Por que é legal
- Excelente para projetos Python.
- Gera documentação de API automaticamente.
- Suporta muitos formatos de saída.
- Tem ecossistema enorme de extensões.
- Muito usado em projetos científicos e técnicos.
Quando usar
Use quando você precisa documentar código Python, bibliotecas, APIs internas ou documentação técnica mais formal.
Limitação
A curva de aprendizado é maior. Ele é poderoso, mas menos “gostoso” de usar que MkDocs para documentação simples em Markdown.
8. MyST + Sphinx
Site: https://myst-parser.readthedocs.io/
O que é
MyST permite usar Markdown dentro do ecossistema Sphinx. É uma ponte entre o poder do Sphinx e uma escrita mais amigável que reStructuredText.
Por que é legal
- Traz Markdown para Sphinx.
- Bom para documentação técnica e científica.
- Funciona bem com referências, equações, citações e notebooks.
Quando usar
Use quando você quer o poder do Sphinx, mas não quer sofrer tanto com reStructuredText.
Limitação
Ainda carrega a complexidade do ecossistema Sphinx.
9. mdBook
Site: https://rust-lang.github.io/mdBook/
O que é
mdBook é uma ferramenta em Rust para criar livros online a partir de Markdown. É muito usado para documentações em formato de livro/manual.
Por que é legal
- Muito bom para livros técnicos.
- Estrutura simples.
- Busca integrada.
- HTML limpo e navegável.
- Binário rápido.
Quando usar
Use para manuais, apostilas, cursos, documentação sequencial ou livros digitais técnicos.
Limitação
Não é tão bom para documentação de produto com muitas seções independentes, landing pages e layout mais rico.
10. GitBook
Site: https://www.gitbook.com/
O que é
GitBook é uma plataforma de documentação e conhecimento. Diferente de MkDocs, não é só um gerador estático local; é uma solução hospedada com colaboração, editor visual, permissões e integrações.
Por que é legal
- Muito fácil para equipes não técnicas.
- Editor bonito.
- Publicação rápida.
- Bom para documentação de produto.
- Recursos de colaboração.
- Integrações com Git e OpenAPI.
Quando usar
Use quando você quer uma plataforma pronta para documentação pública ou interna sem manter infraestrutura.
Limitação
Menos controle e mais dependência de fornecedor. Se você quer tudo versionado em Git e hospedado por você, MkDocs/Docusaurus/VitePress são mais livres.
11. Retype
Site: https://retype.com/
O que é
Retype é um gerador de documentação Markdown-first. Ele promete transformar arquivos .md em um site bonito sem exigir design, código ou dependência de plataforma.
Por que é legal
- Muito simples.
- Visual bom sem esforço.
- Markdown como base.
- Live reload.
- Hospedável em qualquer lugar.
Quando usar
Use quando você quer algo parecido com MkDocs, mas ainda mais focado em “escreva Markdown e publique”.
Limitação
Ecossistema menor que MkDocs/Docusaurus. Antes de apostar em projeto grande, teste plugins, temas e customização.
12. Nextra
Site: https://nextra.site/
O que é
Nextra é um framework de sites de conteúdo em cima do Next.js, com suporte a Markdown/MDX. É bastante usado para documentação moderna.
Por que é legal
- Usa Next.js.
- Suporta MDX.
- Bom para documentação com componentes interativos.
- Tem tema de docs pronto.
- Pode ficar muito bonito e profissional.
Quando usar
Use quando você quer uma documentação com cara de produto moderno e já aceita trabalhar com React/Next.js.
Limitação
Complexidade maior. Se você só quer escrever Markdown e publicar, MkDocs é mais simples.
13. Astro Starlight
Site: https://starlight.astro.build/
O que é
Starlight é um framework de documentação feito com Astro. Ele é focado em sites de documentação bonitos, acessíveis e performáticos.
Por que é legal
- Visual moderno.
- Boa performance.
- Usa Astro.
- Markdown/MDX.
- Bom para docs de produto, projeto e biblioteca.
- Ótimo equilíbrio entre simplicidade e poder.
Quando usar
Use se você quer algo moderno, rápido e mais flexível que MkDocs, mas sem necessariamente entrar no peso total de Docusaurus/Next.js.
Limitação
Ecossistema menor que Docusaurus, mas crescendo.
14. Hugo
Site: https://gohugo.io/
O que é
Hugo é um gerador de sites estáticos em Go, muito rápido e flexível. Embora seja mais geral do que MkDocs, pode ser usado para documentação, blogs, portais e sites institucionais.
Por que é legal
- Extremamente rápido.
- Binário único.
- Bom para sites grandes.
- Tem temas para documentação.
- Suporta taxonomias, menus, conteúdo multilíngue e muitos recursos.
Quando usar
Use se você quer algo mais amplo que documentação: blog, portal, site institucional, biblioteca digital, landing pages e documentação no mesmo projeto.
Limitação
Templates Go podem ser chatos. A experiência de escrita/configuração pode ser menos amigável que MkDocs.
15. Eleventy / 11ty
Site: https://www.11ty.dev/
O que é
Eleventy é um gerador de sites estáticos simples e flexível. Ele aceita vários formatos de template, incluindo Markdown, Liquid, Nunjucks, HTML e outros.
Por que é legal
- Muito flexível.
- Não injeta markup desnecessário.
- Bom para blogs, sites pessoais, zines digitais, documentação customizada e projetos editoriais.
- Controle grande sobre saída HTML.
Quando usar
Use quando você quer liberdade editorial e estrutural, não uma ferramenta fechada em “documentação técnica”.
Limitação
Você monta mais coisa na mão. Para docs técnicas prontas, MkDocs ou Docusaurus dão menos trabalho.
16. Zola
Site: https://www.getzola.org/
O que é
Zola é um gerador de sites estáticos em Rust, distribuído como binário único, com templates Tera e Markdown CommonMark.
Por que é legal
- Binário único.
- Rápido.
- Simples de instalar.
- Bom para blog, documentação, knowledge base e sites estáticos.
- Shortcodes e links internos ajudam bastante.
Quando usar
Use se você gosta da ideia de Hugo, mas quer uma experiência alternativa em Rust e templates mais próximos de Jinja/Django.
Limitação
Comunidade e ecossistema menores que Hugo/Jekyll/MkDocs.
17. Jekyll
Site: https://jekyllrb.com/
O que é
Jekyll é um gerador de sites estáticos em Ruby. Ficou famoso por causa do GitHub Pages.
Por que é legal
- Muito estável.
- Bom para blogs e sites simples.
- Integração histórica com GitHub Pages.
- Usa Markdown e Liquid.
Quando usar
Use para blog, site pessoal, projeto editorial simples ou documentação pequena.
Limitação
Para documentação moderna, MkDocs/Docusaurus/VitePress costumam ser mais agradáveis. Ruby também pode ser uma camada extra de dor se você não usa esse ecossistema.
18. Quarto
Site: https://quarto.org/
O que é
Quarto é um sistema de publicação técnica e científica. Ele usa Pandoc Markdown e pode gerar HTML, PDF, Word, apresentações, websites, livros e documentos com código executável.
Por que é legal
- Excelente para pesquisa, ciência de dados e relatórios técnicos.
- Suporta Python, R, Julia e Observable.
- Gera muitos formatos.
- Suporta citações, equações, crossrefs, callouts e notebooks.
Quando usar
Use para documentação técnica com dados, notebooks, artigos, relatórios, livros e materiais acadêmicos.
Limitação
Para documentação simples de projeto, pode ser mais complexo do que necessário.
19. Antora
Site: https://antora.org/
O que é
Antora é um gerador modular de sites de documentação baseado em AsciiDoc, pensado para documentação multi-repositório, versionada e grande.
Por que é legal
- Excelente para documentação corporativa grande.
- Suporta múltiplos repositórios.
- Suporta componentes e versões.
- Baseado em AsciiDoc, que é mais poderoso que Markdown para documentação complexa.
Quando usar
Use para documentação grande, modular, versionada e mantida por equipes técnicas.
Limitação
Não é tão simples quanto MkDocs. Se você só tem meia dúzia de páginas Markdown, Antora é exagero.
20. Asciidoctor
Site: https://asciidoctor.org/
O que é
Asciidoctor é uma ferramenta para processar AsciiDoc e gerar HTML, PDF, DocBook e outros formatos.
Por que é legal
- AsciiDoc é mais poderoso que Markdown.
- Bom para documentação técnica longa.
- Suporta atributos, includes, admonitions, tabelas melhores e estrutura avançada.
Quando usar
Use quando Markdown começou a ficar curto para suas necessidades.
Limitação
AsciiDoc é menos popular e menos imediato que Markdown. Para equipes pequenas, pode ser barreira.
21. Doxygen
Site: https://www.doxygen.nl/
O que é
Doxygen gera documentação de código-fonte, especialmente para C, C++, Java, Objective-C, Python e outras linguagens.
Por que é legal
- Muito bom para documentação automática de API de código.
- Gera referências de classes, funções, namespaces etc.
- Tradicional em C/C++.
Quando usar
Use quando o foco é extrair documentação diretamente do código.
Limitação
Não é uma ferramenta agradável para escrever documentação narrativa tipo “guia de usuário”. Muitas vezes combina melhor com outra ferramenta.
22. TypeDoc
Site: https://typedoc.org/
O que é
TypeDoc gera documentação para projetos TypeScript a partir dos tipos e comentários do código.
Por que é legal
- Excelente para bibliotecas TypeScript.
- Gera documentação de API automaticamente.
- Entende tipos, interfaces, classes e módulos.
Quando usar
Use em bibliotecas, SDKs e projetos TypeScript.
Limitação
Não substitui documentação narrativa. Ele documenta API; para docs completas, combine com Docusaurus, VitePress, Nextra ou MkDocs.
23. DocFX
Site: https://dotnet.github.io/docfx/
O que é
DocFX é uma ferramenta de documentação muito usada no ecossistema .NET. Gera documentação a partir de código e Markdown.
Por que é legal
- Forte para .NET/C#.
- Mistura documentação conceitual e referência de API.
- Gera sites estáticos.
Quando usar
Use se você trabalha com .NET e quer documentação séria de API + guias.
Limitação
Fora do mundo .NET, pode não ser a escolha mais natural.
24. HonKit
Site: https://github.com/honkit/honkit
O que é
HonKit é um fork/community continuation do antigo GitBook CLI. Serve para criar livros/documentação em Markdown.
Por que é legal
- Familiar para quem gostava do GitBook antigo.
- Bom para livros e manuais em Markdown.
- Open source.
Quando usar
Use se você quer algo no estilo “livro em Markdown”, mas prefere alternativa ao mdBook.
Limitação
Menos popular que mdBook e menos moderno que ferramentas como VitePress/Starlight.
25. BookStack
Site: https://www.bookstackapp.com/
O que é
BookStack é uma plataforma de wiki/documentação self-hosted com interface web, organização em livros, capítulos e páginas.
Por que é legal
- Muito bom para documentação interna.
- Editor visual.
- Organização simples.
- Self-hosted.
- Permissões e usuários.
Quando usar
Use para base de conhecimento interna, documentação de equipe, processos e manuais administrativos.
Limitação
Não é docs-as-code puro. Se você quer tudo em Git/Markdown, MkDocs é mais limpo.
26. Wiki.js
Site: https://js.wiki/
O que é
Wiki.js é uma wiki moderna, self-hosted, com editor web, autenticação, permissões e suporte a múltiplas fontes/armazenamentos.
Por que é legal
- Bonita e moderna.
- Boa para documentação interna.
- Tem permissões, usuários e autenticação.
- Serve como wiki corporativa.
Quando usar
Use para conhecimento vivo de equipe, não necessariamente para documentação de produto pública.
Limitação
Mais pesada que MkDocs. Precisa servidor, banco e manutenção.
27. Dendron
Site: https://www.dendron.so/
O que é
Dendron é uma ferramenta de notas e conhecimento estruturado em Markdown, com integração forte ao VS Code.
Por que é legal
- Bom para conhecimento pessoal e técnico.
- Estrutura hierárquica.
- Markdown.
- Pode virar documentação publicada.
Quando usar
Use para second brain, base de pesquisa, documentação pessoal e organização de conhecimento.
Limitação
Não é tão direto como MkDocs para publicar uma documentação bonita de projeto.
28. Foam
Site: https://foambubble.github.io/foam/
O que é
Foam é uma ferramenta de conhecimento pessoal baseada em Markdown, VS Code e links estilo wiki.
Por que é legal
- Markdown puro.
- Bom para notas conectadas.
- Git-friendly.
- Pode servir como base para documentação pessoal.
Quando usar
Use para notas técnicas, pesquisa, zettelkasten e documentação pessoal.
Limitação
Não é um gerador de documentação pronto como MkDocs.
29. Obsidian Publish / Obsidian + exportação
Site: https://obsidian.md/
O que é
Obsidian é um app de notas em Markdown. Com Obsidian Publish ou fluxos de exportação, pode virar uma base pública de conhecimento.
Por que é legal
- Excelente para escrever e conectar ideias.
- Markdown local.
- Plugins enormes.
- Muito bom para pesquisa, estudos e documentação pessoal.
Quando usar
Use para organizar conhecimento antes de transformar em documentação pública.
Limitação
Para documentação técnica pública com build automatizado, MkDocs ainda é mais apropriado.
30. Read the Docs
Site: https://readthedocs.org/
O que é
Read the Docs é uma plataforma de hospedagem e build para documentação, muito associada a Sphinx e MkDocs.
Por que é legal
- Hospeda documentação automaticamente.
- Integra com Git.
- Suporta versionamento.
- Muito usado em projetos open source.
Quando usar
Use quando você quer publicar documentação de projeto com build automático sem montar pipeline próprio.
Limitação
É uma plataforma de build/hospedagem, não exatamente uma alternativa isolada ao MkDocs.
31. Mintlify
Site: https://mintlify.com/
O que é
Mintlify é uma plataforma moderna para documentação de produto/API, com foco em experiência visual, IA e documentação para desenvolvedores.
Por que é legal
- Visual muito polido.
- Bom para documentação de produto e API.
- Experiência moderna.
- Recursos voltados a devtools/SaaS.
Quando usar
Use se você quer documentação pública com visual comercial forte e não quer construir tudo sozinho.
Limitação
É mais plataforma/produto do que ferramenta self-hosted simples. Avalie custo, lock-in e controle.
32. Fern
Site: https://www.buildwithfern.com/
O que é
Fern é uma plataforma/ferramenta para documentação de API, SDKs e developer experience.
Por que é legal
- Forte para APIs.
- Ajuda a gerar documentação e SDKs.
- Bom para produto dev-first.
Quando usar
Use se seu foco é documentar APIs e criar experiência boa para desenvolvedores externos.
Limitação
Não é substituto simples de MkDocs para documentação geral.
33. Redocly
Site: https://redocly.com/
O que é
Redocly é uma plataforma/ecossistema para documentação de APIs OpenAPI.
Por que é legal
- Excelente para OpenAPI/Swagger.
- Gera referência de API bonita.
- Tem lint, portal e ferramentas para governança de API.
Quando usar
Use para documentação de APIs REST.
Limitação
Não é a melhor escolha para documentação narrativa ampla que não seja API.
34. Swagger UI
Site: https://swagger.io/tools/swagger-ui/
O que é
Swagger UI gera uma interface web interativa para especificações OpenAPI.
Por que é legal
- Padrão de mercado para testar e visualizar APIs.
- Interativo.
- Fácil de integrar em projetos backend.
Quando usar
Use para expor documentação interativa de API REST.
Limitação
Não substitui uma documentação completa de produto. É referência de endpoint, não manual.
35. Scalar
Site: https://scalar.com/
O que é
Scalar é uma ferramenta moderna para documentação e cliente de API, com foco em OpenAPI e developer experience.
Por que é legal
- Visual moderno.
- Boa experiência para API docs.
- Pode substituir Swagger UI em projetos que querem interface mais bonita.
Quando usar
Use quando você quer documentação de API mais moderna e agradável.
Limitação
Foco em API; não é gerador de documentação geral como MkDocs.
Comparação rápida
| Ferramenta | Melhor para | Base de escrita | Complexidade | Self-host fácil? |
|---|---|---|---|---|
| MkDocs | documentação simples e técnica | Markdown | baixa | sim |
| Material for MkDocs | docs bonitas com MkDocs | Markdown | baixa/média | sim |
| Docusaurus | docs modernas de produto | Markdown/MDX | média | sim |
| VitePress | docs rápidas com Vue/Vite | Markdown | baixa/média | sim |
| Docsify | docs sem build | Markdown | baixa | sim |
| Sphinx | docs técnicas/API Python | reST/Markdown via MyST | média/alta | sim |
| mdBook | livros e manuais | Markdown | baixa | sim |
| GitBook | docs com colaboração | editor/Markdown | baixa | plataforma |
| Retype | docs Markdown rápidas | Markdown | baixa | sim |
| Nextra | docs com Next.js | MDX | média | sim |
| Starlight | docs modernas com Astro | Markdown/MDX | média | sim |
| Hugo | sites grandes e rápidos | Markdown | média | sim |
| Eleventy | sites customizados | vários | média | sim |
| Zola | site estático em Rust | Markdown | baixa/média | sim |
| Quarto | pesquisa, dados, relatórios | Pandoc Markdown | média | sim |
| Antora | docs grandes/versionadas | AsciiDoc | alta | sim |
| BookStack | wiki interna | editor web | média | sim |
| Wiki.js | wiki moderna | editor/Markdown | média | sim |
| Redocly | API docs OpenAPI | OpenAPI/Markdown | média | sim/plataforma |
| Swagger UI | referência interativa de API | OpenAPI | baixa | sim |
Minhas recomendações diretas
Se você gostou de MkDocs e quer algo parecido
Teste nesta ordem:
- Material for MkDocs
- Retype
- VitePress
- Docsify
- Starlight
Se você quer documentação de projeto/produto bonita
Teste:
- Docusaurus
- Starlight
- Nextra
- VitePress
Se você quer livro/manual
Teste:
- mdBook
- HonKit
- Quarto Book
Se você quer documentação de API
Teste:
- Swagger UI
- Redocly
- Scalar
- TypeDoc para TypeScript
- Sphinx para Python
- Doxygen para C/C++
Se você quer base de conhecimento interna
Teste:
- BookStack
- Wiki.js
- GitBook
- MkDocs Material em modo docs-as-code
Se você quer algo para pesquisa, compêndios e publicações
Teste:
- Quarto
- Jekyll
- Hugo
- Eleventy
- Zola
Escolha prática para você
Pelo tipo de coisa que você costuma fazer — servidor próprio, Markdown, compêndios, documentação, biblioteca digital, projetos técnicos e publicações — eu testaria assim:
Caminho 1: simples e produtivo
- MkDocs + Material for MkDocs
- Caddy para hospedar
- Git para versionar
Esse é o caminho menos burro. Funciona, escala bem o bastante e não vira novela.
Caminho 2: documentação moderna e bonita
- Starlight ou VitePress
- Caddy para hospedar
- GitHub Actions ou Jenkins para build/deploy
Bom se você quiser visual mais moderno e mais liberdade de frontend.
Caminho 3: livros, cursos e manuais
- mdBook para manuais sequenciais
- Quarto para materiais técnicos/acadêmicos com PDF/HTML
Bom para compêndios, apostilas, estudos e material longo.
Caminho 4: wiki interna
- BookStack ou Wiki.js
Bom se você quiser interface web com login, editor e organização por usuários.
Exemplo de stack boa
Uma stack muito prática seria:
Git + MkDocs Material + Caddy
Fluxo:
Você escreve Markdown
↓
Git versiona
↓
MkDocs gera HTML
↓
Caddy publica com HTTPS
Para algo mais moderno:
Git + Starlight + Caddy
Para livro:
Git + mdBook + Caddy
Para documentação de API:
OpenAPI + Scalar/Swagger UI + Caddy
Conclusão honesta
MkDocs é excelente porque não tenta ser tudo. Ele é simples, direto e bom para documentação em Markdown.
Se você quer algo parecido, mas com cara diferente, vá de Retype, VitePress ou Starlight.
Se você quer documentação de produto mais sofisticada, vá de Docusaurus ou Nextra.
Se você quer livros e manuais, vá de mdBook.
Se você quer documentação técnica pesada, vá de Sphinx.
Se você quer wiki interna, vá de BookStack ou Wiki.js.
O erro seria trocar MkDocs só por curiosidade. Se ele está funcionando bem, continue usando e explore Material for MkDocs até o limite. Só troque quando houver motivo real: necessidade de MDX, React/Vue, versionamento avançado, documentação de API, wiki com usuários ou publicação multi-formato.
Fontes consultadas
- MkDocs: https://www.mkdocs.org/
- Material for MkDocs: https://squidfunk.github.io/mkdocs-material/
- Docusaurus: https://docusaurus.io/
- VitePress: https://vitepress.dev/
- VuePress: https://vuepress.vuejs.org/
- Docsify: https://docsify.js.org/
- Sphinx: https://www.sphinx-doc.org/
- mdBook: https://rust-lang.github.io/mdBook/
- GitBook: https://docs.gitbook.com/
- Retype: https://retype.com/
- Nextra: https://nextra.site/
- Astro Starlight: https://starlight.astro.build/
- Hugo: https://gohugo.io/
- Eleventy: https://www.11ty.dev/
- Zola: https://www.getzola.org/
- Quarto: https://quarto.org/
- Antora: https://antora.org/
Did this resonate?
Related documents
- 001
- 002
- 003
- 004
- 005