Eu mantinha minhas notas no Notion. Funcionava bem — até o dia que tentei fazer grep nos meus arquivos e percebi que eles não existiam no meu computador. Estavam todos em servidores do Notion, acessíveis só pela interface web, em um formato proprietário.
Pra um dev, isso é como ter código que só roda na IDE de outra empresa. Você não é dono dos seus dados.
Foi aí que migrei pro Obsidian.
O que é Obsidian
Obsidian é um app gratuito pra organizar notas em Markdown. Até aí, nada especial — existem dezenas de apps de notas. O que torna o Obsidian diferente são três decisões de design:
-
Local-first. Seus arquivos ficam no seu computador como arquivos
.mdnormais. Não tem banco de dados, não tem formato proprietário, não tem nuvem obrigatória. Se o Obsidian desaparecer amanhã, seus arquivos continuam legíveis em qualquer editor de texto. -
Links bidirecionais. Você pode linkar notas entre si com
[[nome da nota]]. O Obsidian automaticamente cria o backlink — se a nota A linka pra nota B, a nota B sabe que A apontou pra ela. Isso cria uma rede de conhecimento que cresce organicamente. -
Extensível via plugins. A comunidade criou mais de 1.500 plugins. Git sync, Kanban boards, templates, Vim mode, integração com calendário, publicação web — se você consegue imaginar, provavelmente alguém já fez.
Por que devs estão adotando
Devs têm necessidades específicas que o Obsidian atende perfeitamente:
Markdown nativo
Sem editor WYSIWYG que engole sua formatação. É Markdown puro. Você escreve ## Título e é ## Título. Code blocks com syntax highlighting, tabelas, checklists — tudo funciona como esperado.
Git-friendly
Como são arquivos .md, você pode versionar com Git. Isso significa histórico completo, branches, diff, merge. Eu faço push das minhas notas pro GitHub e sincronizo entre máquinas com Git — sem pagar nenhum serviço de sync.
Rápido
Obsidian abre em 2 segundos, mesmo com milhares de notas. O Notion em um browser pesado? Às vezes leva 10+ segundos pra carregar uma página. Pra quem alterna entre notas o dia todo, isso importa.
Graph view
O graph view mostra visualmente como suas notas se conectam. Parece um brinquedo no início, mas quando você tem 100+ notas, ele revela padrões e conexões que você não veria de outra forma. É como um mapa do seu conhecimento.
Funciona offline
Abriu o laptop no avião? No ônibus sem sinal? Suas notas estão lá. Sempre. Sem loading, sem "reconectando", sem "esta página não pode ser carregada".
Obsidian vs. Notion: pra ser justo
Notion é excelente pra colaboração em equipe e projetos com muitas pessoas. Databases, views, permissões — o Notion é imbatível nisso.
Obsidian brilha pra conhecimento pessoal. Notas de estudo, documentação técnica, diário de decisões, runbooks. Tudo que é seu e que você quer controlar.
Não é uma questão de um ser melhor que o outro. É sobre usar a ferramenta certa pro contexto. Eu uso ambos: Notion pra projetos colaborativos, Obsidian pra meu segundo cérebro.
Como eu uso no dia a dia
Minha pasta de notas (que o Obsidian chama de "vault") tem 3 áreas:
- Projetos — uma nota por projeto com decisões, arquitetura, links úteis
- Incidentes — o que aconteceu, quando, como resolvi, o que aprendi
- Referências — configs, comandos, snippets que uso frequentemente
Cada nota tem tags e links pra outras notas. Quando documento um incidente de segurança, linko pro runbook de resposta e pras configs que mudei. Com o tempo, isso cria uma teia de conhecimento onde nada fica isolado.
Obsidian como interface pra IA
Eu uso Obsidian como interface visual pro cérebro do meu agente de IA — veja como montei.
A pasta de notas do Obsidian é a mesma que o Claude Code usa como memória. Eu edito no Obsidian com interface gráfica, o Claude Code acessa via terminal. Os dois leem e escrevem nos mesmos arquivos Markdown.
Com plugins de MCP (Model Context Protocol) e RAG, o Obsidian deixa de ser só um app de notas e vira a base de dados do seu assistente de IA.
Começando em 5 minutos
- Baixe o Obsidian — é gratuito pra uso pessoal
- Crie uma pasta em qualquer lugar do seu computador
- Comece escrevendo uma nota sobre o projeto atual
- Use
[[]]pra linkar pra outras notas - Instale o plugin Obsidian Git se quiser sync via Git
Não tente organizar tudo de uma vez. Comece escrevendo. A estrutura emerge naturalmente conforme você linka notas entre si.
Depois de 2 semanas usando, abra o graph view. É o momento em que a maioria dos devs entende por que as pessoas chamam o Obsidian de "segundo cérebro".