GitBook vs Docsbook: preços, bloqueio e migração

GitBook é a plataforma de documentação escolhida pela Zoom, FedEx, Nvidia e uma longa lista de equipes de médio porte e empresas. Ele parece polido, tem um editor WYSIWYG confortável e o recurso de Pesquisa AI realmente funciona.

Então, por que as equipes procuram uma alternativa ao GitBook?

Porque, dois anos após um contrato com o GitBook, a maioria das equipes percebe as mesmas três coisas: a conta aumenta com cada novo editor na equipe, o conteúdo vive dentro do banco de dados do GitBook em vez de em seu repositório, e a plataforma que prometeu gerenciar seus documentos para sempre agora precisa ser migrada.

Este post é a comparação honesta. Nós fazemos o Docsbook, então diremos quando ele vence. Mas o GitBook é um produto real com verdadeiros pontos fortes, e há equipes que ele se encaixa melhor do que nós. Diremos quais.

TL;DR — Matriz de decisão#

Se você ler apenas uma linha: GitBook é precificado e construído para uma equipe que tem um proprietário de documentação e uma linha de orçamento. Docsbook é precificado e construído para uma equipe onde a documentação vive em docs/ ao lado do código e ninguém quer ser responsável por um sistema de documentação separado.

Por que as equipes deixam o GitBook#

Quatro razões aparecem em todas as conversas sobre churn que temos com novos clientes do Docsbook migrando do GitBook.

1. A conta cresce com o número de pessoas que editam#

O preço do GitBook tem dois eixos. Lendo a partir de sua própria página de preços em 2026-09-03, gitbook.com/pricing lista Gratuito a $0 por site/mês com um usuário, Premium a $65 por site/mês mais $12 por usuário/mês, Ultimate a $249 por site/mês mais $12 por usuário/mês, e Enterprise sob solicitação. Leitores não custam nada — a taxa por usuário se aplica a pessoas que colaboram no conteúdo dentro do aplicativo GitBook.

Essa forma tem uma consequência que vale a pena nomear claramente: cada colega adicional que pode corrigir um erro de digitação adiciona uma linha recorrente à conta. É um modelo coerente — financia o editor WYSIWYG, o fluxo de solicitação de mudança e a equipe de vendas — mas precifica a coisa que a maioria das equipes de produto deseja mais, que são mais engenheiros tocando na documentação.

Docsbook não cobra por editor e não vende níveis. Cada projeto tem seu próprio saldo, e o saldo é gasto em uso de IA; publicar o site, hospedá-lo, servir um domínio personalizado e cada página que um leitor abre não consome nada dele. Qualquer pessoa na sua equipe do GitHub pode editar o Markdown subjacente, porque o editor é aquele que eles já usam. Os números atuais estão em docsbook.io/pricing.

2. O bloqueio de fornecedor é real#

O Git Sync do GitBook é um complemento, e mesmo com ele ativado, a fonte canônica é o banco de dados do GitBook. Se você parar de pagar, seu conteúdo não fica onde você pode continuar trabalhando nele.

Vimos isso acontecer da mesma forma três vezes: uma equipe decide sair, exporta seu conteúdo e descobre que a exportação é um ZIP de arquivos Markdown que não corresponde à estrutura de seu repositório, com links de imagem apontando para o CDN do GitBook. A migração não é um botão. É um projeto.

O Docsbook é o modelo inverso. Seu Markdown fica em seu repositório do GitHub. Nós o indexamos, renderizamos e enviamos. Se você parar de pagar, a documentação ainda estará bem ali em docs/ — o que você perde é o site hospedado, o chat de IA e as traduções. O ativo continua sendo seu porque nunca se moveu.

3. A migração do Docusaurus ou do Markdown custa metade#

Se seus documentos estão atualmente em uma docs/ pasta de arquivos Markdown (que é onde a maioria das equipes de engenharia os mantém), migrar para o GitBook significa colá-los no editor do GitBook ou configurar a sincronização do Git e torcer para que a importação lide com seu front matter, componentes personalizados e caminhos de imagem.

A maioria das equipes subestima isso. O editor do GitBook é um editor baseado em blocos, não um editor de Markdown — então componentes MDX, chamadas escritas como :::note, e tabelas que funcionam bem em Markdown podem ser renderizadas de forma ligeiramente errada ou precisam ser refeitas.

Docsbook lê seu Markdown como está. Se README.md e uma docs/ pasta funcionam no GitHub, elas funcionam no Docsbook em 5 segundos. Frontmatter, tabelas GFM, cercas de código, links de imagem — todos renderizados sem qualquer reformatagem.

4. A pesquisa de IA é uma caixa de seleção, não um fosso mais#

Em 2024, a Pesquisa de IA foi a razão para pagar pelo GitBook. Em 2026, toda plataforma de documentação séria a possui. A questão não é mais "você tem IA" — é "quanto custa a IA além do assento do editor que já estou pagando, e de onde vem meu tráfego de IA."

O Docsbook mede a IA em dólares em relação ao saldo do projeto, em vez de restringi-la a um nível, então a questão "qual plano tem IA" não surge. O servidor MCP está incluído, o que significa que os usuários do Claude Code e do Cursor leem e editam seus documentos diretamente, e llms.txt e llms-full.txt são publicados automaticamente no nível da plataforma e por espaço de trabalho.

Essa última parte importa mais do que parece. A Mintlify mediu 30 dias de tráfego nos sites de documentação que hospeda — aproximadamente 790 milhões de solicitações — e relatou que os agentes de codificação de IA representaram 45,3% de todas as solicitações, com Claude Code em 25,2% e Cursor em 18,0% (O estado do tráfego de agentes na documentação, publicado em 3 de abril de 2026). Sua medição de acompanhamento colocou a participação dos agentes em 66% do tráfego em julho de 2026 (O estado do tráfego de docs: um relatório de meio de ano de 2026, publicado em 29 de julho de 2026). Essa é a frota de um fornecedor, não da web inteira — mas é a maior medição publicada do tráfego de agentes para documentação, e a direção não é sutil.

Comparação de recursos lado a lado#

Como os dois modelos de preços realmente se comparam?#

Não podem ser comparados como dois números, porque medem coisas diferentes — e essa diferença é toda a decisão.

Duas consequências seguem. No GitBook, a equipe de docs mais barata é uma pequena, então o modelo desencoraja silenciosamente a coisa que a maioria das organizações de engenharia deseja — mais engenheiros editando docs. No Docsbook, a equipe de docs mais barata é aquela cujos leitores encontram a resposta na página em vez de perguntar ao assistente, então o modelo recompensa a escrita da página.

Faça a aritmética em relação ao tamanho da sua própria equipe na página do fornecedor. Este post publica deliberadamente nenhum exemplo trabalhado: os números do GitBook mudam, os nossos são gerados por solicitação, e uma tabela de ambos estaria errada dentro de um trimestre após a publicação. docsbook.io/pricing é regenerado a partir das constantes de preços ao vivo em cada solicitação, que é por isso que é o único número que vale a pena citar de volta para nós.

Caminho de migração: GitBook → Docsbook#

Se você está considerando a mudança, aqui está o caminho realista. Nós vimos isso acontecer várias vezes.

1. Exportar do GitBook. Use a exportação de espaço do GitBook para obter seu conteúdo como Markdown. Espere corrigir caminhos de imagem e qualquer estranheza do editor de blocos manualmente — conte com meio dia a um dia, dependendo de quantos blocos personalizados você usou.
2. Coloque os arquivos em uma docs/ pasta em qualquer repositório do GitHub. Público ou privado. Se você não tiver um repositório, crie um.
3. Cole a URL do repositório no Docsbook. O site entra no ar em 5 segundos em docsbook.io/owner/repo. Verifique se tudo é renderizado corretamente.
4. Conecte seu domínio personalizado. Aponte o DNS para o Docsbook para servir docs.yourcompany.com com SSL automático.
5. Ative o chat de IA e traduções. Opcional, mas barato para ativar. A maioria das equipes ativa no mesmo dia.
6. Configure redirecionamentos no antigo domínio do GitBook. Use Cloudflare Workers, Netlify ou um serviço de redirecionamento para enviar *.gitbook.io/yourspace/* para os novos caminhos.
7. Cancele o GitBook.

Todo o processo geralmente é um projeto de um ou dois dias. A parte mais longa é corrigir as peculiaridades do editor de blocos no Markdown exportado, e esse é um custo único.

Quando o GitBook é realmente a melhor escolha#

Preferimos que você permaneça no GitBook do que comprar o Docsbook e ficar desapontado. Aqui estão os casos em que o GitBook se encaixa melhor.

• Seus editores de docs não são técnicos. O editor WYSIWYG do GitBook permite que gerentes de produto, líderes de suporte e escritores contribuam sem aprender Markdown ou Git. Se metade dos seus editores não sabe o que é um pull request, o GitBook é a ferramenta certa.
• Você precisa de coedição em tempo real. O GitBook suporta edição multiusuário ao vivo no navegador. O Docsbook não — seu modelo de colaboração é "git push".
• Você precisa de fluxos de trabalho ramificados com solicitações de mudança dentro do editor. A interface de solicitação de mudança do GitBook é madura. O Docsbook deixa isso para os PRs do GitHub, que é a escolha certa se seus editores são engenheiros e a escolha errada se não forem.
• Você está comprando para uma equipe empresarial que requer SOC 2 Tipo II, SAML SSO e um CSM dedicado. O GitBook tem tudo isso embalado. O Docsbook está se movendo nessa direção, mas ainda não chegou lá.
• Você já está no GitBook, sua equipe está feliz e a conta é aceitável. O custo de migração é real. Se a configuração atual funciona, não conserte o que não está quebrado.

Se nada do acima se aplica a você, o Docsbook é quase certamente a melhor opção.

FAQ#

O Docsbook é open source? Não, mas seu conteúdo é. Seu Markdown vive no seu repositório do GitHub e você pode parar de pagar pelo site hospedado a qualquer momento sem perder o acesso a uma única página.

O Docsbook suporta repositórios privados? Sim. Você autoriza o Docsbook a ler um repositório privado, e o site publicado pode ser privado ou público, dependendo das suas configurações.

Posso continuar editando no GitBook e espelhar no Docsbook? Você pode, mas isso perde o sentido. Escolha uma fonte de verdade. Se o GitBook é seu, fique no GitBook. Se o GitHub é seu, venha para cá.

O que acontece com meu SEO se eu migrar? Configure redirecionamentos 301 de cada URL antiga do GitBook para o caminho correspondente do Docsbook. Os motores de busca seguem um 301 e carregam os sinais de classificação; um caminho que você esquece de redirecionar é o que perde tráfego. O Docsbook emite tags meta por página e JSON-LD por padrão, então as novas páginas não estão perdendo a marcação que as antigas tinham — mas nenhuma plataforma pode prometer uma classificação, e esta não promete.

O Docsbook tem busca por IA como o GitBook? Sim. O chat de IA é treinado com seus próprios documentos, e seu custo é medido em dólares contra o saldo do projeto, em vez de estar restrito a um nível. Você também pode trazer sua própria chave de API — OpenRouter, OpenAI, Anthropic ou Gemini — e pagar diretamente ao provedor.

Posso personalizar a aparência? Sim. Logotipo, favicon, cores de destaque para claro e escuro, Google Fonts e alternâncias de visibilidade por componente — barra de pesquisa, botão de copiar, link de editar no GitHub, botão de chat de IA e o resto. A única coisa que você não pode desligar é o pequeno link "Powered by Docsbook" no rodapé da página: ele aparece em todos os sites do Docsbook, incondicionalmente.

A verdade nua e crua#

GitBook é um ótimo produto para um público específico: equipes de médio porte e empresas que desejam edição WYSIWYG, colaboração ao vivo e não se importam em pagar por editor.

Docsbook é um bom produto para um público diferente: equipes cujos documentos já estão no GitHub, que não querem que seu conteúdo fique dentro do banco de dados de um fornecedor e que preferem pagar pelo que a IA realmente faz do que pelo número de pessoas autorizadas a editar.

Se você é o primeiro público, GitBook é a escolha certa. Se você é o segundo, Docsbook é a melhor opção — e o fator decisivo não é o preço hoje, mas qual número cresce quando a equipe cresce.

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

Próximos passos#

• Migrando do GitBook para o Docsbook — a exportação, a importação e a lista de redirecionamento
• Alternativas ao Docusaurus em 2026: 9 plataformas comparadas — o campo mais amplo, se o GitBook não for seu único candidato
• Plataformas de documentação de IA comparadas — a matriz de recursos de IA em quatro plataformas gerenciadas
• Domínio personalizado para documentação — os passos de DNS e SSL para docs.yourcompany.com