> ## Documentation Index
> Fetch the complete documentation index at: https://docs.apollospace.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Documentos

> Editor rich-text do Apollo Space — markdown + WYSIWYG, mentions, embeds, colaboração.

## Pra que servem

**Documentos** são páginas de texto rico onde mora o conhecimento
da operação que não cabe num card de board nem num lead de CRM:

* Briefings de cliente
* Procedimentos operacionais (SOPs)
* Decisões e ATA de reunião
* Propostas em rascunho
* Voice + tom de comunicação
* Pesquisa de mercado, análises
* Templates pra clonar

Diferente de um arquivo no Notion ou Google Docs, esses documentos
vivem **dentro do contexto da org** — agentes consultam, leads
podem ser mencionados, integrações podem injetar conteúdo. O
[Brain](/features/brain) usa os documentos como uma das fontes
principais de conhecimento.

## Modo híbrido — markdown + WYSIWYG

O editor é **híbrido**:

* Você digita em **markdown** quando souber (atalho)
* O texto renderiza em **WYSIWYG** automaticamente
* Botões de formatação na barra superior funcionam pra quem prefere
  click

Resultado: ninguém precisa decorar markdown, mas quem sabe digita
mais rápido. **#** vira H1, **##** H2, **-** vira bullet, **\`** vira
inline code, etc.

## O que dá pra colocar num doc

<CardGroup cols={2}>
  <Card title="Texto rico" icon="text-height">
    Headers, bullets, numbered lists, blockquotes, code blocks com
    syntax highlight (Python / JS / SQL / etc.), inline code.
  </Card>

  <Card title="Tabelas" icon="table">
    Add coluna, add linha, drag pra reordenar. Sem células
    mescladas (mantém simplicidade).
  </Card>

  <Card title="Imagens" icon="image">
    Upload direto (drag-drop) ou paste do clipboard. Inline ou
    block (a largura escolhe).
  </Card>

  <Card title="Embeds" icon="link">
    Links externos viram preview rico (com title + descrição +
    favicon). YouTube / Loom embedam o player inline. PDFs viram
    viewer.
  </Card>

  <Card title="Mentions" icon="at">
    `@usuário` notifica a pessoa. `@agente` envolve agente no doc
    (ex.: `@scout` revisar este briefing). `#lead-uuid` linka pra
    lead específico do CRM.
  </Card>

  <Card title="Checklist" icon="list-check">
    Mesma sintaxe do markdown (`- [ ]`). Marcar/desmarcar persiste
    pro doc inteiro — bom pra ATA de reunião com ação items.
  </Card>
</CardGroup>

## Colaboração

<AccordionGroup>
  <Accordion title="Edição simultânea" icon="users">
    Múltiplas pessoas editando ao mesmo tempo. Cursor de cada um
    aparece com cor + nome. Conflitos resolvidos via CRDT — você
    não perde texto mesmo em latência ruim.
  </Accordion>

  <Accordion title="Comentários inline" icon="comment">
    Selecione um trecho → ícone de comentário aparece. Thread no
    sidebar. Mention `@user` pra notificar. Comments podem ser
    resolvidos (somem) ou abertos pra revisita.
  </Accordion>

  <Accordion title="Versão / histórico" icon="clock-rotate-left">
    Cada save gera versão. Você abre "Histórico" pra ver linha do
    tempo + restaurar uma versão antiga. Versões são append-only —
    nada é deletado.
  </Accordion>

  <Accordion title="Sharing" icon="share-nodes">
    Default: visível pra todos os membros da org com acesso à
    pasta. Override: pode esconder doc específico, gerar link
    público com expiração (sem login), exigir senha pra abrir.
  </Accordion>
</AccordionGroup>

## Agentes e documentos

Como os documentos vivem dentro do Brain, **agentes consultam
automaticamente** durante operação:

* Marcus carrega o doc de **voz da org** ao compor outbound
* Scout cruza pesquisa pública com docs internos (ICP, persona)
* Athena lê um briefing do cliente antes de propor próximos passos

Você pode também **invocar agente direto no doc** via mention
`@scout` ou `@athena` — eles respondem inline com comentário
ou append no fim.

## Templates

Templates são documentos especiais que servem de molde:

| Template                | Pra que                                                  |
| ----------------------- | -------------------------------------------------------- |
| **ATA de reunião**      | Nome / data / participantes / decisões / ação items      |
| **Briefing de cliente** | Empresa / pain / objetivo / contexto / próximos passos   |
| **Proposta comercial**  | Cabeçalho / problema / solução / preço / próximos passos |
| **SOP (procedimento)**  | Quando aplicar / quem executa / passos / output esperado |
| **Retro**               | O que foi bem / o que pode melhorar / ações              |

Você cria templates próprios em **Settings → Templates → Novo**.
Org inteira pode usar (ou só você se marcar como pessoal).

## Export

Cada documento pode ser exportado:

* **Markdown** (.md) — fonte original, ideal pra clonar pra outro
  sistema
* **PDF** — pra mandar pra cliente / arquivar
* **HTML** — pra publicar (incluído em e-mail / site)

Export preserva embeds, imagens (inline base64 em PDF/HTML),
mentions (resolvidas pra nome).

## Search

Documentos são **indexados** pra busca global (`⌘K`):

* Busca por título + corpo
* Resultados ranqueados por relevância semântica
* Highlights do trecho que matchou

Brain usa o **mesmo índice** + adiciona busca semântica via
embeddings. Veja [Brain](/features/brain).

## Limites

| Limite                   | Valor                               |
| ------------------------ | ----------------------------------- |
| **Tamanho do doc**       | \~100k caracteres (\~50 páginas A4) |
| **Imagens por doc**      | Sem limite (storage da org agrega)  |
| **Mentions**             | Sem limite                          |
| **Histórico de versões** | Mantido enquanto a org existir      |

Pra docs muito longos (book-style), considere quebrar em múltiplos
docs com links cruzados. Texto monolítico vira difícil de navegar.

## Audit

| Evento                       | O que registra                                        |
| ---------------------------- | ----------------------------------------------------- |
| `doc_created`                | Quem criou + onde (pasta)                             |
| `doc_edited`                 | Quem editou + diff (não conteúdo cru, só estatística) |
| `comment_added` / `resolved` | Quem + quando + trecho                                |
| `version_restored`           | Quem reverteu + de qual pra qual versão               |
| `doc_shared_externally`      | Link público gerado + expiração                       |

Owner + Admin inspecionam em **Doc → ... → Histórico de auditoria**.

## Próximos passos

<CardGroup cols={2}>
  <Card title="Brain" icon="brain" href="/features/brain">
    Como agentes usam os docs pra alimentar resposta.
  </Card>

  <Card title="Pastas" icon="folder" href="/features/pastas">
    Onde os docs ficam organizados.
  </Card>

  <Card title="Boards" icon="square-kanban" href="/features/boards">
    Pra workflow de delivery (em vez de doc estático).
  </Card>
</CardGroup>