Comparação de hospedagem de documentação gratuita: seis opções reais

"Gratuito" raramente significa gratuito. Cada opção de hospedagem de documentação gratuita tem um custo real em tempo de configuração, recursos ausentes ou eventual atualização. Esta é a comparação que lhe diz qual "gratuito" está mais próximo de realmente ser gratuito.

Nós fazemos o Docsbook. Listamos nossas limitações honestamente.

TL;DR#

Se sua prioridade é "viver hoje com boas configurações padrão", o Docsbook vence. Se sua prioridade é "quero possuir cada camada", o GitHub Pages + um gerador estático vence. Tudo entre isso é um compromisso.

Docsbook#

O que você recebe, sem pagar nada para publicar:

• Configuração de 5 segundos a partir de um repositório GitHub
• Cores de marca personalizadas (claro e escuro), logotipo, ícone, fonte
• Pesquisa, breadcrumbs, copiar código, alternar tema
• Links de cabeçalho e links sociais (GitHub, Discord, X)
• Análises — visualizações de página, páginas principais, referenciadores, países
• llms.txt e llms-full.txt para descobribilidade de IA
• Um servidor MCP, para que Claude Code e Cursor possam ler e editar os documentos
• Chat de IA treinado com seu conteúdo

O que custa e o que não custa:

• Publicação, hospedagem, o domínio personalizado e cada página que um leitor abre não custam nada. Eles não consomem nenhum saldo.
• O uso de IA é medido. Cada projeto possui seu próprio saldo, e perguntas ao assistente e execuções de tradução o consomem. Os números atuais estão em docsbook.io/pricing, gerados a partir das constantes de preços ao vivo em cada solicitação.
• O crédito do rodapé é permanente. Cada site Docsbook exibe um pequeno link "Powered by Docsbook" no rodapé da página. Não há configuração e nenhum plano que o remova.

Melhor para: projetos OSS, produtos independentes, MVPs e qualquer pessoa que queira um site de documentação real sem gerenciar hospedagem.

GitHub Pages#

O que você recebe:

• Hospedagem gratuita para sites estáticos
• Domínio personalizado gratuito
• Jekyll embutido ou qualquer gerador estático via Actions
• Uptime decente, CDN incluído

O que você não recebe:

• Busca pronta (você adiciona Algolia ou cria a sua própria)
• Chat AI (sem integrações)
• Analytics (você adiciona Google Analytics ou similar)
• Construções automáticas sem escrever GitHub Actions
• Qualquer coisa além do que seu gerador estático produz

Custo real:

• 1–4 horas de configuração inicial, incluindo DNS
• Horas recorrentes quando seu gerador estático tem atualizações críticas
• Aprovação do Algolia DocSearch (semanas de espera, negação possível)

Melhor para: engenheiros de OSS que gostam de ter controle sobre a pilha e querem custo recorrente zero.

Camada gratuita do Vercel#

O que você recebe:

• Camada gratuita generosa para sites estáticos e sem servidor
• Domínios personalizados, SSL automático
• Excelente desempenho de construção e CDN global
• Implantações de pré-visualização para cada PR

O que você não recebe:

• Uma configuração ciente de documentação (você traz seu próprio framework)
• Chat de IA, pesquisa, análises — todos os seus problemas
• Gratuito é a camada de hobby; uso comercial requer Pro

Custo real:

• O tempo de configuração depende inteiramente do framework que você escolher (Next.js, Astro, Vite, etc.)
• Minutos de construção após a camada gratuita
• A atualização "Pro" a $20/usuário/mês quando você comercializa

Melhor para: equipes que já usam Vercel para o restante de sua pilha e têm um framework de documentação escolhido.

Camada gratuita do Netlify#

Semelhante ao Vercel — camada gratuita forte para sites estáticos, domínios personalizados, CDN.

Mesmas advertências: você traz o framework, a busca, a IA, a análise.

Limites de largura de banda (100GB/mês na gratuita) podem ser problemáticos se sua documentação se tornar viral.

Melhor para: mesmo público que o Vercel.

ReadTheDocs gratuito#

O que você recebe:

• Gratuito para projetos OSS (pago para comercial)
• Suporte a Sphinx e MkDocs
• Documentação versionada pronta para uso
• Alguma busca

O que você não recebe:

• Domínio personalizado no gratuito
• Chat de IA
• Temas modernos (os temas do Sphinx são funcionais, não bonitos)
• Fluxo de trabalho baseado em frontmatter

Custo real:

• Complexidade do Sphinx se você ainda não o utiliza
• Formato RST se você usar os padrões do Sphinx
• $50/mês para uso comercial com domínio personalizado

Melhor para: Projetos OSS em Python com configuração Sphinx existente.

Cloudflare Pages#

O que você recebe:

• Camada gratuita generosa
• Domínio personalizado gratuito com Cloudflare DNS
• Desempenho de CDN
• Minutos de construção incluídos

O que você não recebe:

• Recursos cientes de documentos
• Qualquer coisa pré-construída para documentação

Mesmas advertências que Vercel e Netlify — você traz tudo acima da camada de hospedagem.

Melhor para: equipes já no Cloudflare com forte capacidade de DevOps.

O custo oculto: tempo#

A opção de custo em dólar mais barata raramente é a opção de custo total mais barata.

Faça essa aritmética com seus próprios números em vez dos nossos: pegue o custo horário da pessoa que faria a configuração, multiplique pelas horas na tabela acima e compare isso com a alternativa. Não publicamos nenhum valor em dólar para isso, porque uma taxa horária que inventamos para você seria um número fictício disfarçado de cálculo.

O que o Docsbook troca por essas horas é concreto e pequeno: todo site carrega um link "Powered by Docsbook" em seu rodapé, em todos os sites, sem possibilidade de removê-lo.

O custo oculto: aumento de funcionalidades#

A maioria das equipes que escolhem uma opção gratuita auto-hospedada acaba adicionando:

• Algolia DocSearch ($60+/mês após aprovação)
• Um chatbot SaaS ($30–100/mês)
• Análise ($0–50/mês)
• Pipeline de tradução (semanas de engenharia)

Compare os preços com o Docsbook em docsbook.io/pricing em vez de um número citado aqui. A forma da comparação é o que importa: a pilha auto-hospedada acumula várias assinaturas mensais fixas mais o tempo de engenharia para conectá-las, enquanto o Docsbook cobra pelo uso de IA e nada pelo site.

Como escolher#

• Você vai gastar mais de duas horas configurando a hospedagem de documentos? → Docsbook
• Você é uma equipe OSS Python já no Sphinx? → ReadTheDocs
• Você quer ter controle sobre cada camada e aproveitar isso? → GitHub Pages ou Cloudflare Pages
• Você precisa de docs.yourcompany.com no primeiro dia? → Docsbook, Netlify ou Cloudflare Pages
• Você vai publicar em várias línguas? → Docsbook, que indexa cada localidade em sua própria URL

Por que esta página não cita nosso próprio preço?#

Porque um preço copiado em um post de blog fica desatualizado sem avisar ninguém, e um preço desatualizado é a única coisa mais prejudicial que uma página de comparação pode ter: é exatamente a frase que um leitor — ou um assistente de IA resumindo esta página seis meses a partir de agora — repetirá para um comprador.

docsbook.io/pricing é gerado a partir das constantes de preços ao vivo em cada solicitação. Não tem data de "última atualização" porque não há nada nele que possa ficar desatualizado. Leia o número lá; trate qualquer preço do Docsbook que você encontrar em qualquer outro lugar, incluindo aqui, como um rumor.

Comece grátis — sem cartão de crédito

Próximos passos#

• Melhores plataformas de documentação para startups em 2026 — o mesmo campo classificado por estágio da empresa
• Como hospedar documentação do GitHub — o passo a passo para os três principais caminhos
• Transforme seu README.md em um site de documentação — o caminho mais curto se sua documentação for um arquivo
• Domínio personalizado para documentação — DNS, SSL e redirecionamentos para docs.yourcompany.com