Como Parar de Configurar Wikis e Começar a Escrever Documentação

Uma história conhecida: sua equipe ou você pessoalmente precisa de uma base de conhecimento. Você abre Wiki.js, Outline ou, Deus me livre, Confluence. Uma hora depois, você se vê deep in configuring PostgreSQL, Redis, S3 storage, and a three-hundred-line Docker Compose file. Nesse ponto, a vontade de anotar algumas ideias inteligentes geralmente desaparece.

Recentemente descobri o LeafWiki. O autor do projeto aparentemente compartilha dessa dor. É uma wiki auto-hospedada sem firulas que funciona no princípio de "baixe e execute". Sem dependências pesadas, apenas um único binário Go e uma pasta de dados.

Por Trás dos Panos

LeafWiki não tenta reinventar a roda. Baseia-se em três coisas diretas: Go para o backend, React para a interface e SQLite para metadados. O melhor — o conteúdo real das páginas é armazenado em arquivos Markdown simples no disco.

Isso significa que se o servidor subitamente travar ou você decidir migrar para outra ferramenta, seus dados não vão se transformar em uma abóbora presa dentro de um banco de dados proprietário. Você pode abrir com qualquer editor de texto ou até mesmo no Obsidian.

O Que Faz Ela Ser Boa na Prática

Com frequência vejo ferramentas que se chamam "simples" mas que na verdade exigem administração completa. LeafWiki é mais honesto nisso.

Estrutura de Árvore em Vez de Caos

Muitas ferramentas modernas de anotações apostam em listas "planas" com tags. Aqui você obtém uma estrutura de árvore clássica. Você mesmo define a hierarquia e, o mais importante, pode ordenar manualmente as páginas dentro das seções. Isso é crítico para documentos de onboarding ou procedimentos onde a ordem de leitura importa.

Um Editor Que Não Atravanca

Ele vem com um editor Markdown integrado com visualização ao vivo. Suporta tabelas, listas de tarefas, notas de rodapé e até diagramas Mermaid com fórmulas matemáticas KaTeX. Há auto-completar para links internos — comece a digitar o nome de outra página e a wiki automaticamente insere o link correto.

Links Inteligentes

O sistema rastreia backlinks. Em cada página, você pode ver o que a referencia. Se você renomear ou mover uma página, o LeafWiki pode atualizar automaticamente os links em outros documentos (esse recurso precisa ser habilitado com uma flag --enable-link-refactor).

Backup para os Paranoicos

Além de simplesmente copiar a pasta de dados, versões recentes adicionaram suporte experimental para backup Git. A wiki vai fazer push automático das alterações para seu repositório remoto em um agendamento.

Para Quem Isso Não É

Deixe-me ser claro desde o início: isso não é um substituto do Notion. Não há edição colaborativa em tempo real onde você vê os cursores dos colegas. Nem fluxos de trabalho complexos de aprovação de publicação. Se você precisa de dez pessoas editando simultaneamente o mesmo parágrafo — continue procurando.

Além disso, o LeafWiki ainda não suporta controle de acesso granular até branches individuais da árvore. Papéis existem (admin, editor, leitor), mas se aplicam a toda a wiki.

Como Começar

Se você tem o Docker instalado, subir leva cerca de trinta segundos.

docker run -p 8080:8080 \
    -v ~/leafwiki-data:/app/data \
    ghcr.io/perber/leafwiki:latest \
    --jwt-secret=super-secret-key \
    --admin-password=your-password \
    --allow-insecure=true

A flag --allow-insecure=true é necessária se você estiver executando o projeto localmente sem HTTPS. Se planeja expor externamente via Nginx ou outro proxy, é melhor remover essa flag.

Aliás, para os minimalistas, há um instalador pronto para Linux que registra o LeafWiki como um serviço do sistema:

sudo /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/perber/leafwiki/main/install.sh)"

Trabalhando a Partir de Dispositivos Móveis

A interface é responsiva. Editar texto de um celular é um prazer questionável, mas ler documentação em movimento ou corrigir rapidamente um erro de digitação é perfeitamente possível.

LeafWiki conquista você com sua previsibilidade. É uma ótima escolha para:

• Um diário técnico pessoal ou base de conhecimento.
• Documentação para um projeto pequeno.
• Runbooks internos para admins ou engenheiros DevOps.

Se você está cansado de lutar com engines de wiki pesadas e só quer escrever Markdown que fica organizado de forma organizada — experimente esse projeto. Atualmente tem menos de mil estrelas no GitHub, mas definitivamente tem potencial para se tornar "aquela ferramenta simples" que você一直在 procurando.