Docsbook
Visão geral

GEO — Otimização do Motor Generativo

Em 2025, uma parcela crescente de desenvolvedores pergunta ao Perplexity, ChatGPT Search, Google AI Overviews e Claude em vez de digitar uma consulta no Google. Esses motores resumem respostas e citam suas fontes — e a forma como seus documentos estão estruturados controla diretamente se eles são escolhidos.

GEO é a prática de escrever e marcar conteúdo para que motores generativos o encontrem fácil de extrair, atribuir e citar.

O que o Docsbook faz quando o GEO está ativado#

Ative GEO na aba de administração SEO / GEO. Uma vez ativado, cada página de documentação recebe:

Resumo em TL;DR no topo#

Um resumo curto é inserido logo após o H1 como um bloco estilizado <aside class="tldr">. Ordem da fonte:

  1. Se seu frontmatter markdown contiver um campo tldr: explícito — essa string é usada literalmente (até 280 caracteres).
  2. Caso contrário — o Docsbook extrai o primeiro parágrafo após o H1 e o corta de forma limpa para se ajustar.

Este é o trecho que a maioria dos motores de IA escolhe ao resumir sua página.

Data de última modificação visível#

Uma linha como “Atualizado em 25 de maio de 2026” aparece no final de cada artigo, com um elemento <time dateTime="..."> apropriado. Modelos de IA pesam fortemente a atualidade — páginas sem uma data visível muitas vezes são ignoradas em favor de concorrentes datados.

A data vem do último commit que tocou o arquivo em seu repositório do GitHub.

Atribuição de autor como Person esquema#

O JSON-LD da página muda author de uma referência Organization genérica para um objeto Person completo:

{
  "@type": "Person",
  "name": "Jane Doe",
  "url": "https://github.com/janedoe",
  "sameAs": ["https://github.com/janedoe"]
}

Ordem de origem: author: e authorUrl: explícitos no frontmatter, caso contrário, o último autor do git do GitHub.

HTML Semântico#

O corpo do artigo está envolto em <article> com uma estrutura descritiva. O bloco TL;DR expõe role="note" para tecnologia assistiva e parsers de IA.

Como tornar uma página mais citável#

Alguns padrões de autoria aumentam dramaticamente a frequência com que uma página é citada:

  • Adicione um tldr: frontmatter explícito com uma resposta direta de 1 a 2 frases para a principal pergunta da página. Não confie na extração automática se você puder escrever algo mais conciso.
  • Comece com uma resposta direta, depois expanda. Modelos de IA analisam os primeiros 200 a 300 caracteres de forma mais agressiva.
  • Use frases curtas e autossuficientes com números e datas concretas — estas são mais fáceis de extrair como citação.
  • Defina author: e authorUrl: no frontmatter quando a página tiver autoridade sobre o assunto que vale a pena atribuir.
  • Mantenha os títulos H2/H3 formulados como perguntas ou imperativos ("Como configurar webhooks", "O que é um espaço de trabalho?") — eles correspondem à forma como os usuários formulam consultas.

Como habilitar#

  1. Abra o painel de administração do seu espaço de trabalho (FloatWidget) → aba SEO / GEO.
  2. Ative GEO — Otimização do Motor Generativo.
  3. A alteração se aplica a todas as páginas neste espaço de trabalho imediatamente na próxima renderização.

Updated

Desenvolvido por Docsbook