Murad Library
Murad LibraryREF-0328MD

Ferramentas parecidas com MkDocs para documentação, sites estáticos e bases de conhecimento

Catalogued
Reading
22 min read

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:

  1. Você quer escrever em Markdown puro?
  2. Precisa de busca interna?
  3. Precisa de versionamento de documentação?
  4. Vai hospedar sozinho em Caddy/Nginx?
  5. Quer algo minimalista ou bonito pronto?
  6. Precisa de plugins?
  7. Precisa documentar API automaticamente?
  8. Quer usar Git como fonte da verdade?
  9. Precisa de colaboração não técnica?
  10. 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.html e 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

FerramentaMelhor paraBase de escritaComplexidadeSelf-host fácil?
MkDocsdocumentação simples e técnicaMarkdownbaixasim
Material for MkDocsdocs bonitas com MkDocsMarkdownbaixa/médiasim
Docusaurusdocs modernas de produtoMarkdown/MDXmédiasim
VitePressdocs rápidas com Vue/ViteMarkdownbaixa/médiasim
Docsifydocs sem buildMarkdownbaixasim
Sphinxdocs técnicas/API PythonreST/Markdown via MySTmédia/altasim
mdBooklivros e manuaisMarkdownbaixasim
GitBookdocs com colaboraçãoeditor/Markdownbaixaplataforma
Retypedocs Markdown rápidasMarkdownbaixasim
Nextradocs com Next.jsMDXmédiasim
Starlightdocs modernas com AstroMarkdown/MDXmédiasim
Hugosites grandes e rápidosMarkdownmédiasim
Eleventysites customizadosváriosmédiasim
Zolasite estático em RustMarkdownbaixa/médiasim
Quartopesquisa, dados, relatóriosPandoc Markdownmédiasim
Antoradocs grandes/versionadasAsciiDocaltasim
BookStackwiki internaeditor webmédiasim
Wiki.jswiki modernaeditor/Markdownmédiasim
RedoclyAPI docs OpenAPIOpenAPI/Markdownmédiasim/plataforma
Swagger UIreferência interativa de APIOpenAPIbaixasim

Minhas recomendações diretas

Se você gostou de MkDocs e quer algo parecido

Teste nesta ordem:

  1. Material for MkDocs
  2. Retype
  3. VitePress
  4. Docsify
  5. Starlight

Se você quer documentação de projeto/produto bonita

Teste:

  1. Docusaurus
  2. Starlight
  3. Nextra
  4. VitePress

Se você quer livro/manual

Teste:

  1. mdBook
  2. HonKit
  3. Quarto Book

Se você quer documentação de API

Teste:

  1. Swagger UI
  2. Redocly
  3. Scalar
  4. TypeDoc para TypeScript
  5. Sphinx para Python
  6. Doxygen para C/C++

Se você quer base de conhecimento interna

Teste:

  1. BookStack
  2. Wiki.js
  3. GitBook
  4. MkDocs Material em modo docs-as-code

Se você quer algo para pesquisa, compêndios e publicações

Teste:

  1. Quarto
  2. Jekyll
  3. Hugo
  4. Eleventy
  5. 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

Did this resonate?

Related documents