12k
All articles

5 Dicas de Obsidian para Melhores Anotações

Cinco dicas do Obsidian para notas: MOC, Dataview, Bases, Canvas, Mermaid, painéis de revisão e sincronização Git do vault.

OpenReplay Team
OpenReplay Team
5 Dicas de Obsidian para Melhores Anotações

Os hábitos de maior impacto no Obsidian não são sobre capturar mais notas — são sobre tornar as notas que você já tem localizáveis, conectadas e reutilizáveis. Tomando emprestada uma frase precisa da escrita de sistemas de Dann Berg: saiba sempre se você está trabalhando no seu sistema de anotações ou com ele para realizar trabalho de verdade. A maioria dos vaults se deteriora porque seus donos fazem bastante do primeiro e quase nada do segundo — capturar é fácil, reutilizar é a parte difícil. As cinco práticas abaixo têm como foco exatamente a reutilização, escritas para desenvolvedores que já dominam Markdown com fluência, portanto não há aqui nenhuma introdução básica sobre cabeçalhos e listas.

Principais Conclusões

  • Um Map of Content (MOC) é uma nota-hub que conecta notas relacionadas com [[wikilinks]]; combiná-lo com uma query do Dataview faz com que o hub se organize sozinho, em vez de exigir que você mantenha uma lista manualmente.
  • Use o Dataview para queries inline baseadas em texto; recorra ao Bases — o plugin nativo de banco de dados do Obsidian desde agosto de 2025 — quando quiser uma visualização em tabela, cartão, lista ou mapa filtrável sem código.
  • O Canvas é um plugin nativo integrado, e o Obsidian renderiza diagramas mermaid nativamente, permitindo que você diagrame uma arquitetura de serviços sem instalar nada.
  • A parte difícil das anotações é a reutilização: um dashboard semanal do Dataview com notas modificadas nos últimos sete dias transforma um vault de escrita única em um que você revisita.
  • Um vault do Obsidian é apenas uma pasta de arquivos Markdown, então git init oferece histórico de versões gratuito, diffs por linha e sincronização entre máquinas sem necessidade de pagar pelo Obsidian Sync.

1. Construa Maps of Content — e saiba quando o Bases supera o Dataview

Um Map of Content (MOC) é uma nota-hub que conecta notas relacionadas com [[wikilinks]] e utiliza uma query para organizá-las automaticamente. Em vez de manter manualmente uma tabela com todas as notas do payments-service, você escreve os links conforme avança e deixa uma query exibi-los. A versão mais simples usa o Dataview, um plugin de query da comunidade, para listar todas as notas que apontam de volta para o MOC atual:

LIST FROM [[]]

FROM [[]] resolve para “notas que apontam para esta nota”, então qualquer nota que você marcar com [[Payments MOC]] aparecerá aqui sem nenhuma manutenção. O Dataview lê suas notas e nunca as modifica — sua documentação é explícita ao afirmar que ele não altera metadados — portanto uma query não pode corromper um vault.

A atualização importante de 2026 que todos os posts mais antigos ignoram: o Obsidian Bases é um plugin nativo gratuito que transforma suas notas em um banco de dados editável e filtrável dentro do Obsidian. Ele foi lançado como plugin nativo em 18 de agosto de 2025, e todos os dados em uma base são suportados pelos seus arquivos Markdown locais e propriedades armazenadas em YAML. Conforme a documentação do Bases, trata-se de um plugin nativo para visualizações semelhantes a bancos de dados sobre arquivos e propriedades: tabelas, cartões, listas e mapas. Isso torna a escolha uma decisão real, não um padrão automático:

Use o Dataview quando…Use o Bases quando…
Você quer queries inline na nota como texto simplesVocê quer uma visualização filtrável por GUI sem código
Você precisa de rollups de tarefas ou campos inline calculadosVocê quer layouts em tabela, cartão, lista ou mapa
Sua lógica é orientada a código e expressivaVocê quer algo estável, nativo e compatível com dispositivos móveis

Ambos funcionam com o mesmo frontmatter YAML, então investir em propriedades bem definidas (status:, repo:, updated:) traz retorno independentemente de qual você escolher.

Crie links com intenção: links descritivos tornam seu grafo navegável, enquanto links vagos viram ruído. [[JWT refresh-token rotation]] indica exatamente o que está do outro lado, enquanto “veja mais aqui” produz um link que você nunca mais vai encontrar. O retorno se acumula: como todo wikilink é bidirecional, o painel de backlinks em [[OAuth token refresh flow]] torna-se um índice dinâmico de cada registro de incidente, nota de standup e documento de design que o tocou — sem que você precise manter um índice.

Mantenha cada nota atômica — uma ideia por nota. Uma nota atômica sobre a semântica de retry do [[repo: payments-service]] é reutilizável em dezenas de contextos; a mesma ideia enterrada em um dump de reunião de 2.000 palavras é invisível. Notas atômicas também são onde surgem novos pensamentos — conecte duas notas não relacionadas e a interseção é a ideia que nenhuma das fontes continha. Mantenha as notas curtas e com propósito único, e deixe os links, não as pastas, carregarem a estrutura.

3. Diagrame sistemas com Canvas e Mermaid

O Canvas é um plugin nativo integrado, não um complemento da comunidade — a lista de plugins nativos o descreve como uma forma de organizar notas visualmente em um espaço infinito para dispor ideias. Coloque notas ativas em uma superfície infinita e conecte-as para esboçar uma arquitetura de serviços, uma linha do tempo de incidentes ou o fluxo de controle de um algoritmo, com cada cartão apontando de volta para a nota completa no seu vault.

Para diagramas que pertencem dentro de uma nota, incorpore um bloco mermaid — o Obsidian o renderiza nativamente sem instalação de plugin (a versão atual inclui o Mermaid 11.13.0):

```mermaid
graph TD
    A[Client request] --> B[API gateway]
    B --> C{Auth valid?}
    C -->|Yes| D[Service handler]
    C -->|No| E[401 -> refresh flow]
    D --> F[(Postgres)]
```

Isso renderiza um fluxograma do ciclo de vida de uma requisição na visualização de leitura. Por ser texto simples no corpo da nota, o diagrama gera diffs limpos no Git (veja a dica 5) e acompanha a nota — sem imagem binária para regenerar quando a arquitetura mudar.

4. Transforme as anotações do Obsidian em uma base de conhecimento viva que você revisita

A parte difícil das anotações não é a captura, é a reutilização — a maioria das notas é escrita uma vez e nunca mais aberta. Trate seu vault como uma base de conhecimento viva, não como um arquivo morto: notas são mutáveis, e você deve refatorá-las, reconectá-las e podá-las conforme as revisita. O mecanismo que torna isso consistente é uma query de revisão permanente. Crie uma nota de dashboard com um bloco Dataview mostrando tudo que você tocou nos últimos sete dias:

LIST
WHERE file.mtime >= date(today) - dur(7 days)
SORT file.mtime DESC

Abra-a toda sexta-feira, e o vault deixa de ser somente de escrita. Adicione uma query complementar para tarefas abertas (TASK WHERE !completed) e vincule o comando nativo Random Note a um atalho de teclado para redescoberta aleatória. O hábito importa mais do que a query: uma nota que você nunca reabre é uma nota que você nunca escreveu.

5. Versione e sincronize seu vault com Git

Um vault do Obsidian é apenas uma pasta de arquivos Markdown, então executar git init dentro dele oferece histórico de versões gratuito, diffs por linha e sincronização entre máquinas — sem necessidade de pagar pelo Obsidian Sync. Você já possui a ferramenta; aponte-a para o seu vault:

cd my-vault
git init
printf '.obsidian/workspace.json\n.obsidian/workspace-mobile.json\n.trash/\n' > .gitignore
git add .
git commit -m "Initial vault snapshot"

O .gitignore mantém fora do histórico os estados locais de alta rotatividade (layout de janela, lixeira), preservando suas notas, configurações de plugins e arquivos .base. A partir daí, git log e git diff mostram exatamente como uma nota evoluiu — o tipo de trilha de auditoria que aplicativos de notas proprietários não conseguem oferecer. Faça push para um repositório privado remoto e git pull nas outras máquinas para sincronizar.

Uma ressalva honesta: Git é versionamento mais sincronização assíncrona, não colaboração em tempo real — edite a mesma nota em duas máquinas antes de fazer pull e você resolverá um conflito de merge manualmente, assim como no código. Para um vault solo, é uma troca justa. E se este for um vault de trabalho, não há nada a licenciar: o Obsidian é gratuito para uso comercial desde fevereiro de 2025, com a licença comercial paga agora sendo opcional.


Escolha uma dessas dicas para implementar esta semana — o git init leva quinze minutos e o dashboard de revisão é uma única query — em vez de tentar todas as cinco de uma vez. O objetivo não é um sistema mais elaborado; é um vault cujas notas você realmente reabre, conecta e reutiliza.

Perguntas Frequentes

O Bases está substituindo o Dataview no Obsidian?

Não. O Bases é um plugin nativo lançado pelo Obsidian em 18 de agosto de 2025 que oferece visualizações de banco de dados filtráveis por GUI sem código, enquanto o Dataview continua sendo um plugin da comunidade que oferece uma linguagem de query expressiva baseada em texto dentro das notas. Ambos leem do mesmo frontmatter YAML. O Dataview ainda funciona e é amplamente utilizado; a comunidade cada vez mais o combina com o Bases ou o substitui por ele, mas o Dataview não foi descontinuado nem abandonado.

Posso sincronizar um vault do Obsidian com Git sem perder as configurações dos plugins?

Sim. Um vault armazena a configuração dos plugins na pasta .obsidian como arquivos simples, que o Git rastreia junto com suas notas Markdown. Adicione ao .gitignore apenas os estados locais de alta rotatividade, como .obsidian/workspace.json, .obsidian/workspace-mobile.json e .trash/. Isso preserva os plugins da comunidade, atalhos de teclado, temas e arquivos .base entre máquinas, mantendo o ruído de layout de janela fora do histórico. O Git cuida do versionamento e da sincronização assíncrona, não da colaboração em tempo real.

O Dataview modifica ou corrompe minhas notas ao executar queries?

Não. O Dataview apenas lê o conteúdo e os metadados das notas para exibir e calcular resultados; sua documentação oficial afirma que ele nunca edita suas notas ou metadados e sempre os deixa intactos. As queries renderizam a saída na visualização de leitura sem gravar de volta nos arquivos de origem, portanto uma query malformada produz um erro de exibição em vez de alterar ou corromper os dados do vault.

Preciso pagar por uma licença para usar o Obsidian no trabalho?

Não. Desde 20 de fevereiro de 2025, o Obsidian é gratuito para uso comercial em organizações de qualquer porte. A licença comercial anteriormente exigida, com preço de 50 dólares por usuário por ano, agora é opcional e existe apenas como uma forma de apoiar o Obsidian. Isso significa que gerenciar um vault de trabalho com Git ou usar o Obsidian em máquinas da empresa não acarreta nenhum custo obrigatório de licenciamento.

O Canvas é um plugin nativo do Obsidian ou um complemento da comunidade?

O Canvas é um plugin nativo integrado, não uma instalação da comunidade. A lista de plugins nativos do Obsidian o descreve como uma forma de organizar notas visualmente em um espaço infinito para dispor ideias. Você o ativa nas configurações sem precisar baixar nada do catálogo da comunidade. O Canvas permite que você coloque notas ativas do vault em uma superfície infinita e as conecte, de modo que os cartões permaneçam vinculados às suas notas de origem completas.

Understand every bug

Uncover frustrations, understand bugs and fix slowdowns like never before with OpenReplay — self-hosted, with full data ownership.

Star on GitHub

We use cookies to improve your experience. By using our site, you accept cookies.