Manual: escrever e organizar

Como criar, editar, organizar, compartilhar e recuperar documentos.

Coleções: onde os documentos moram

Uma coleção (na tela, projeto) agrupa os documentos de uma área ou de um projeto. Crie uma pelo botão Novo projeto na barra lateral.

  • Sigla: de 2 a 6 letras ou números (ex.: HUB). Vira o prefixo do código das histórias e dos cards, como HUB-7.
  • Grupo: um rótulo que junta coleções na barra lateral, por exemplo por cliente. Crie com Novo grupo.
  • Configurar projeto (engrenagem da coleção): dados gerais, repositórios e links, templates de código, tipos de documento, agentes e acesso.

A página da coleção mostra os documentos fixados, a lista com filtro por tipo e, quando há integração, os MRs abertos e o changelog do GitLab.

Escrever

Digite / em uma linha vazia para abrir o menu de blocos. Comece a digitar o nome para filtrar (o menu aceita a palavra sem acento):

BlocoPara quê
Titulo 1, 2 e 3Estrutura do texto (e os slides da apresentação)
Lista, Lista numerada, Lista de tarefasTarefas podem ser aninhadas
CitacaoDestaca uma citação
Aviso (callout)Um bloco de destaque, no tom informativo
Codigo, Diagrama (Mermaid)O diagrama é desenhado a partir do texto
TabelaColunas redimensionáveis
Bloco recolhívelEsconde detalhes até alguém abrir
Imagem (URL)Mostra uma imagem a partir de um endereço
Anexar arquivoGuarda o arquivo na wiki, com link para baixar
Embed (YouTube, Figma, Loom, URL…)Mostra o conteúdo de outro serviço dentro do documento
Quebra de paginaControla onde o PDF e a impressão mudam de página

Atalhos úteis:

  • @ ou [[ cita outro documento e cria um link para ele. O documento citado passa a mostrar, em Mencionado em, de onde foi citado.
  • Arraste o bloco pela alça à esquerda para mudar a ordem.
  • Selecione um trecho para formatar, comentar, Melhorar com IA ou Gerar diagrama do trecho (IA) — fluxograma, sequência, classes, entidade-relacionamento ou mapa mental.
  • Arraste um arquivo para dentro do texto, ou cole uma imagem, para guardá-lo na wiki.

O documento salva sozinho, e você vê quem mais está na página. Quando outra pessoa salva:

  • se você não tem alteração pendente, o texto se atualiza sozinho;
  • se tem, aparece Atualizado por outra pessoa. Recarregar traz a versão dela e descarta o que você ainda não salvou.

Não há edição simultânea letra a letra: quem salva por último grava o próprio texto. Combinem quem edita, para um salvamento não ficar por cima do outro — e, se acontecer, a versão anterior continua no histórico.

Modo quadro e mapa mental

Cada documento pode ser uma página ou um quadro (Excalidraw, desenho livre). Troque o modo no topo do documento. No quadro, a IA gera o mapa mental do conteúdo da página.

Tipos de documento

Um tipo (ou modelo) dá forma ao documento: o texto inicial que aparece ao criar e as instruções que a IA segue ao redigir. Escolha o tipo ao criar o documento ou depois, no seletor do documento. A coleção filtra e conta os documentos por tipo.

Comentários, versões e tags

  • Comentários: selecione um trecho e comente. Os comentários ficam no painel lateral.
  • Versões: cada gravação vira uma versão. No painel lateral, compare duas versões e restaure a que quiser — a restauração vira uma versão nova, então nada se perde.
  • Tags e favoritos: marque documentos para achá-los depois. Os favoritos ficam no topo da barra lateral.

Buscar

Aperte ⌘K (Ctrl+K no Windows e no Linux) e digite. A busca procura em todo o conteúdo e ignora acentos. Dentro de um documento, ⌘F (Ctrl+F) busca no próprio texto.

Compartilhar, exportar e apresentar

  • Compartilhar com link público (o globo no topo, para quem edita): gera um link só de leitura, para quem não tem conta. O link mostra o título e um trecho quando colado no WhatsApp, Slack ou Telegram. Desfaça quando quiser.
  • No menu ⋮: Exportar PDF, Exportar Word (.docx) e Imprimir.

A impressão e o PDF usam o cabeçalho, o rodapé e as margens de Configurações → Impressão.

O botão Apresentar (slides), no topo do documento, mostra a página como slides em tela cheia. O título do documento vira a capa, e cada título do texto (ou uma linha ---) começa um slide. Navegue com as setas ou a barra de espaço, f alterna a tela cheia e Esc sai. O link público também oferece a apresentação.

Importar

  • Para dentro de um documento: no menu ⋮, Importar .md. Atenção: o arquivo substitui todo o texto do documento aberto (a versão anterior fica no histórico).
  • Muitos documentos de uma vez: em Configurações → Importar, envie um .zip de Markdown, a exportação HTML do Confluence ou a exportação de outra Next Wiki, e escolha a coleção de destino.

Lixeira

Mover para a lixeira (menu ⋮) tira o documento da árvore sem apagá-lo. A página Lixeira mostra os 200 mais recentes; ali você restaura ou exclui de vez. A exclusão definitiva não tem volta.