Manual de Obsidian on RanceLee的博客

Atalhos de Teclado do Obsidian: Construa Memória Muscular

Mon, 01 Jan 0001 00:00:00 +0000

Anteriormente, cobrimos plugins de recorte do navegador — salvando conteúdo da web no Obsidian com um clique, formatação limpa e metadados preenchidos automaticamente. Este capítulo adota uma abordagem diferente: em vez de como colocar coisas para dentro, vamos falar sobre como usar o próprio Obsidian de forma mais eficiente.

Por Que Vincular Atalhos de Teclado

Vamos começar com a Paleta de Comandos. Cmd+P é um dos melhores recursos do Obsidian. Abra a paleta, digite o que deseja fazer, pressione Enter e pronto. Não há necessidade de lembrar onde os botões estão ou vasculhar menus.

Mas depois de usar por um tempo, surge um problema: comandos demais. O Obsidian vem com dezenas de comandos principais e, com plugins da comunidade, o número facilmente ultrapassa uma centena. Toda vez que você abre a Paleta de Comandos, precisa pensar “qual é o nome desse comando?”, digitá-lo, esperar a lista filtrar e então pressionar Enter.

Para ações de baixa frequência, esse fluxo de trabalho é perfeitamente aceitável. Mas para ações de alta frequência — como inserir um template ou recolher todos os cabeçalhos — passar por isso toda vez se torna irritante.

Os atalhos de teclado resolvem isso: vincule as ações mais comuns a teclas convenientes, acione-as diretamente, sem pensar. Depois que você se acostuma, descobre que essas ações se tornam pura memória muscular — suas mãos pressionam as teclas antes mesmo de você pensar.

Acessando as Configurações de Atalhos de Teclado

Caminho: Configurações (Cmd+,) → Encontre “Hotkeys” na barra lateral esquerda.

Ao entrar na página de Hotkeys, você verá uma longa lista de comandos. Cada linha é um comando com três colunas:

Coluna esquerda: Nome do comando (incluindo o plugin de origem)
Coluna do meio: Atalho atualmente vinculado (vazio se não vinculado)
Coluna direita: Botões de ação

Pesquisando e Vinculando

No topo da página, há uma caixa de pesquisa que suporta pesquisa difusa. Por exemplo, se você quiser vincular “Inserir Template”, basta digitar “template” e os comandos relevantes são filtrados imediatamente.

Após encontrar o comando desejado:

Passo 1: Clique no botão + à direita.

Passo 2: Pressione a combinação de teclas que deseja vincular, como Cmd+T. O Obsidian reconhece automaticamente e a exibe.

Passo 3: Pressione Enter para confirmar, ou clique em outro lugar para fechar, e o vínculo está completo.

Se não quiser mais um atalho, clique no botão × à direita para desvinculá-lo, restaurando-o para vazio.

Lidando com Conflitos

Ao vincular atalhos, você pode ocasionalmente encontrar um conflito — a tecla que deseja vincular já está ocupada por outro comando. O Obsidian destacará o conflito e informará qual comando está usando essa tecla.

A correção é simples:

Anote o nome do comando conflitante.
Pesquise por esse comando, clique em × para desvinculá-lo.
Volte e vincule o comando desejado, ou escolha uma combinação de teclas diferente.

Um pequeno detalhe: Após o Obsidian 1.6, algumas combinações de teclas não podem ser vinculadas na interface gráfica e serão exibidas como inválidas. Se você encontrar isso, pode editar diretamente o arquivo .obsidian/hotkeys.json no diretório do seu cofre para adicioná-las manualmente — mas a maioria das teclas não tem esse problema, então usar a GUI é suficiente.

Minha Lista de Vinculações Recomendadas

Nem todo comando vale a pena vincular um atalho. Os critérios são simples: alta frequência + várias etapas. Para comandos que você usa ocasionalmente, basta pesquisar com Cmd+P — não precisa ocupar espaços mentais para teclas.

Aqui estão os que eu uso:

Comando	Atalho Padrão	Vinculação Recomendada	Descrição
Inserir Template	Nenhum	Cmd+T	Uma das ações mais frequentes, obrigatório vincular
Alternar Modo Leitura/Edição	Cmd+E	Usar padrão	O padrão já é conveniente, não precisa mudar
Recolher Todos os Cabeçalhos	Nenhum	Cmd+[	Use quando a estrutura da nota for longa
Expandir Todos os Cabeçalhos	Nenhum	Cmd+]	Use junto com o acima
Alternar Barra Lateral Esquerda	Nenhum	Cmd+\	Esconder barra lateral ao focar na escrita
Nova Nota	Cmd+N	Usar padrão	O padrão é suficiente
Abrir Alternador Rápido	Cmd+O	Usar padrão	Pular rapidamente entre diferentes notas

Se você tiver o plugin Templater instalado (mais poderoso que o plugin de template principal, que será abordado separadamente), ele também tem seu próprio comando — “Templater: Abrir Modal de Inserir Template” — e recomendo vincular um atalho para ele também.

Não recomendo vincular tudo de uma vez. Comece com dois ou três dos mais frequentes e adicione mais à medida que se acostumar. Vincular muitas teclas pode ser confuso se você não conseguir lembrá-las.

Resumo

O que você aprendeu hoje:

Entrada de configurações de atalhos: Configurações (Cmd+,) → Hotkeys, gerencie todos os atalhos aqui
Método de vinculação: Pesquise o nome do comando → Clique em + → Pressione a combinação de teclas → Confirme
Desvinculação: Clique em ×, o atalho retorna para vazio
Lidando com conflitos: Obsidian destaca conflitos, desvincule o antigo primeiro e depois reatribua

Pontos-chave:

Apenas vincule ações de alta frequência + várias etapas, comandos de baixa frequência são suficientes com Cmd+P
Comece com dois ou três mais comuns, expanda gradualmente à medida que se acostumar, não vincule muitos de uma vez
Priorize estes: Inserir Template (Cmd+T), Recolher/Expandir Todos os Cabeçalhos (Cmd+[/]), Alternar Barra Lateral Esquerda (Cmd+)

Claudian: Coloque o Claude Code na Barra Lateral do Obsidian

Mon, 01 Jan 0001 00:00:00 +0000

Existem três maneiras de integrar IA com o Obsidian: fornecendo diretamente caminhos de arquivos, usando o Obsidian CLI e usando Skills. Entre elas, a combinação de CLI e Skills oferece os melhores resultados, mas também tem a maior barreira de entrada — você precisa ter o terminal aberto, entender comandos CLI e escrever ou modificar Skills por conta própria.

Se você acha isso muito complicado, ou se apenas ocasionalmente quer que a IA ajude a processar anotações sem toda essa configuração, o plugin apresentado hoje é uma alternativa mais leve: Claudian.

Como a Abordagem do Plugin Difere do Uso Direto do Terminal

Antes de falar sobre o Claudian, vamos esclarecer a diferença fundamental entre essas duas abordagens.

Ao usar o terminal diretamente, você tem duas janelas: Obsidian e Claude Code. Você está escrevendo notas no Obsidian e quer que a IA ajude a processar algo. Você muda para o terminal e diz: “Dê uma olhada neste arquivo: /Users/you/Obsidian/SomeNote.md”. Após a IA processar, você volta para o Obsidian para ver os resultados. Você fica pulando entre duas janelas, e cada vez precisa especificar manualmente em qual arquivo está trabalhando.

A abordagem do plugin é diferente. O Claudian incorpora a IA na barra lateral do Obsidian. Qualquer nota que você abrir, a IA automaticamente sabe o que você está vendo. Você não precisa especificar o caminho; basta conversar no painel à direita. Quando terminar, você não precisa trocar de janela — os resultados são refletidos diretamente na nota.

Para usar uma analogia: a abordagem do terminal é como ter um escritório ao lado — você tem que correr até lá e dizer “Por favor, processe este documento”, depois trazer o arquivo de volta. A abordagem do plugin é como ter um assistente bem na sua mesa — você diz “Me ajude a editar este parágrafo”, e ele trabalha ali mesmo na sua frente.

Uma coisa que vale a pena esclarecer: o Claudian essencialmente ainda chama o Claude Code CLI. Suas capacidades são as mesmas de usar o Claude Code diretamente no terminal; não está usando uma IA diferente. A única diferença é o ponto de entrada — foi movido do terminal para a barra lateral do Obsidian.

Então, se você já está usando seriamente a abordagem Skill + CLI, o Claudian não é um substituto mais forte — ele apenas torna a operação mais suave. Se você não usa muito o terminal, ou se acha essa configuração muito pesada, o Claudian é um ponto de entrada mais adequado para você.

O que é o Claudian

Claudian é um plugin do Obsidian criado por YishenTu. É open-source sob a licença MIT. Repositório no GitHub:

https://github.com/YishenTu/claudian

Lançado no início de 2026, rapidamente ganhou mais de 4.500 estrelas e se espalhou rapidamente entre usuários do Obsidian e do Claude.

Atualmente, ainda não está disponível no mercado oficial de plugins do Obsidian, portanto, a instalação manual é necessária.

Como Instalar

Antes de instalar, certifique-se de duas coisas:

Você tem o Claude Code CLI instalado (versão de linha de comando, não a versão web)
Sua versão do Obsidian é 1.8.9 ou mais recente

Estes são pré-requisitos; ambos são necessários. Para instalar o Claude Code, consulte a documentação oficial: claude.com/code.

O plugin suporta uma ampla gama de modelos: assinatura Claude, API Key ou plataformas que suportam o formato da API Anthropic como OpenRouter e DeepSeek.

Método de Instalação 1: Download Manual do GitHub Release (Recomendado)

Acesse https://github.com/YishenTu/claudian/releases e abra a página do último lançamento
Baixe três arquivos: main.js, manifest.json, styles.css
No seu Vault, encontre a pasta .obsidian/plugins/ e crie uma nova pasta chamada claudian
Coloque os três arquivos nessa pasta
Abra o Obsidian → Configurações → Plugins da comunidade → Encontre Claudian → Ativar

Método de Instalação 2: Instalação Automática com o Plugin BRAT

BRAT é uma ferramenta especificamente para instalar plugins que ainda não estão no mercado oficial. Após a instalação, o BRAT também notificará automaticamente sobre atualizações do Claudian.

Pesquise por BRAT nos Plugins da Comunidade do Obsidian, instale e ative-o
Abra as configurações do BRAT e clique em “Add Beta plugin”
Insira https://github.com/YishenTu/claudian e clique em Add Plugin
Após a instalação, ative o Claudian em Plugins da Comunidade

Ambos os métodos funcionam; o download manual é mais direto, enquanto o BRAT facilita as atualizações.

O que o Claudian Pode Fazer

Chat na Barra Lateral, Opere Diretamente no Seu Vault

Clique no ícone de robô na faixa esquerda, ou use a paleta de comandos para abrir o painel do Claudian. Um painel de chat aparecerá à direita.

Quando você conversa com a IA aqui, ela pode executar ações diretamente no seu Vault: ler arquivos, escrever arquivos, pesquisar conteúdo, executar comandos — as mesmas capacidades de usar o Claude Code no terminal. A única diferença é que você nunca sai da interface do Obsidian.

Ciente Automaticamente da Nota Atual

Acho esse recurso o mais conveniente.

Qualquer nota que você abrir, o Claudian a anexa automaticamente ao contexto. A IA sabe o que você está vendo sem que você precise especificar o caminho do arquivo toda vez.

Se quiser referenciar outros arquivos, digite @ na caixa de chat. Uma lista suspensa aparecerá, permitindo selecionar arquivos do Vault, ou referenciar serviços MCP ou Agents personalizados.

Além disso, você pode marcar certas notas (por exemplo, private), e o Claudian pulará automaticamente esses arquivos, não enviando seu conteúdo para a IA.

Edição Inline: Selecione o Texto e Edite Diretamente

Esse recurso é útil quando você quer apenas editar um parágrafo sem deixar a IA modificar a nota inteira.

Selecione o texto que deseja editar, acione a tecla de atalho (que você pode personalizar), e um pequeno painel aparece. Você pode dar instruções como “Deixe isso mais conversacional” ou “Traduza isso para o inglês”, e a IA processa apenas a parte selecionada.

Suporte a Imagens

Você pode enviar imagens no chat: arrastar e soltar, colar uma captura de tela ou inserir o caminho do arquivo de imagem — os três métodos funcionam.

Após ver a imagem, a IA pode descrever seu conteúdo, extrair texto, responder perguntas como “Do que se trata esta imagem?”, etc. Isso é bastante útil para pessoas que tiram capturas de tela com frequência para anotações.

Comandos de Barra

Digite / e uma lista de seus modelos de comando predefinidos aparecerá.

Por exemplo, se você usa frequentemente a ação “Resumir os pontos-chave da nota atual”, pode salvá-la como /summarize. Na próxima vez, basta digitar /summarize e o comando se expande, para que você não precise redigitá-lo toda vez.

Os modelos podem incluir placeholders de parâmetros, referenciar @files e até incorporar comandos bash. Se você usa Claude Code Skills, o Claudian reconhece o mesmo formato, então eles podem ser compartilhados entre ambos.

Modo de Planejamento

Pressione Shift+Tab para alternar para o modo Plan.

Neste modo, a IA não modificará diretamente seus arquivos. Em vez disso, ela primeiro explorará e planejará, apresentando o plano para sua confirmação antes de executar.

Isso é adequado para tarefas maiores, como “Me ajude a organizar a estrutura da pasta 01-notes/” ou “Mesclar essas notas em um único resumo.” Se você executar essas operações diretamente, a IA pode mudar muitas coisas que você não antecipou. Revisar o plano primeiro é muito mais seguro do que lidar com uma bagunça depois e ter que desfazer as alterações.

Modos de Permissão

O Claudian tem três modos de permissão que controlam se você precisa confirmar quando a IA executa ações:

YOLO: Totalmente automático. A IA executa qualquer ação sem pop-ups. Mais eficiente, mas você precisa confiar no julgamento da IA.
Safe: Um pop-up pede sua confirmação toda vez que a IA quer modificar um arquivo. Seguro, mas confirmações frequentes podem interromper seu fluxo.
Plan: Este é o Modo de Planejamento descrito acima. Planeje primeiro, depois execute.

Para uso diário, YOLO é suficiente. Se você se importa mais com a estrutura do seu Vault, pode usar Safe. Antes de operações grandes, mude para Plan para revisar primeiro.

Seleção de Modelo

Você pode alternar entre Haiku, Sonnet e Opus para atender às necessidades de precisão de diferentes tarefas. Use Haiku para perguntas simples para economizar tokens; use Sonnet para organizar notas complexas; use Opus para tarefas de raciocínio profundo.

Resumo

O que aprendemos hoje:

A diferença central entre a abordagem do plugin e a abordagem do terminal: sem necessidade de alternar janelas, a IA sabe automaticamente a nota atual
Claudian é um plugin que incorpora o Claude Code na barra lateral do Obsidian; ele ainda chama o Claude Code CLI internamente
A instalação requer Claude Code CLI + Obsidian 1.8.9+, e pode ser feita via download manual do GitHub Release ou usando BRAT
Recursos principais: chat na barra lateral, anexo automático da nota atual, Edição Inline, suporte a imagens, Comandos de Barra, Modo de Planejamento, controle de permissão

Pontos-chave:

Se você não quer lidar com o terminal e Skills, o Claudian é um ponto de entrada de barreira mais baixa
Se você já está usando a abordagem CLI + Skill, o Claudian não é um substituto, mas uma maneira de tornar as operações mais suaves
Edição Inline é adequada para edições locais precisas; Modo de Planejamento é adequado para operações em larga escala
Os modos de permissão variam de YOLO → Safe → Plan, tornando-se mais cautelosos conforme avança; escolha com base no cenário

Colaboração de IA no Obsidian: Da Conversa à Ação

Mon, 01 Jan 0001 00:00:00 +0000

Este capítulo inicia a quinta parte: Colaboração com IA.

As quatro partes anteriores cobriram o próprio Obsidian — como começar, configurar, escrever e publicar. Esta parte aborda o outro lado: com ferramentas de IA como Claude Code e Codex, que podem ler e escrever diretamente em arquivos locais, seu cofre Obsidian não é mais apenas um caderno para você ler; ele também se torna uma bancada onde a IA pode trabalhar diretamente.

Este capítulo primeiro explica como começar, com três métodos em ordem crescente de dificuldade e automação:

O método mais simples: dar diretamente o caminho do arquivo para a IA, deixar que ela leia e processe o arquivo original
Obsidian CLI: mais eficiente do que ler arquivos diretamente, adequado quando seu cofre tem muitos arquivos
Skill: solidificar todo o fluxo de trabalho em um único comando, totalmente automatizado

Dar Diretamente o Caminho do Arquivo para a IA

Este é o método mais simples — sem necessidade de plugins, sem conhecimento de CLI.

A IA aqui se refere a ferramentas como Claude Code ou Codex que podem ler e escrever diretamente em arquivos locais, não a interfaces de chat baseadas na web como DeepSeek ou ChatGPT.

Você só precisa dar ao Claude Code ou Codex o caminho completo para um arquivo, e ele pode ler o arquivo e processá-lo diretamente no original. Por exemplo:

“Resuma os pontos principais desta nota: /Users/yourusername/Documents/Obsidian/01Notes/some-note.md”
“Traduza este artigo para o inglês e sobrescreva o original”
“Verifique este rascunho em busca de erros de digitação e problemas de lógica, e corrija-os”

A IA lê o conteúdo do arquivo, entende sua solicitação e escreve o conteúdo modificado de volta. Resumo, tradução, polimento, ajustes de formatação — essas tarefas pontuais são bem adequadas para este método.

A barreira é extremamente baixa; você pode usar imediatamente. A única desvantagem é que você precisa especificar manualmente a solicitação e o caminho toda vez, tornando-o adequado para uso ocasional.

Obsidian CLI

Dar caminhos de arquivo diretamente funciona, mas quando seu cofre tem muitos arquivos, a IA escanear arquivos cegamente fica lenta e os resultados podem não ser precisos. É aí que entra a CLI.

Após atualizar para a versão mais recente do Obsidian, uma interface CLI está disponível, permitindo que a IA opere diretamente em seu cofre por meio de comandos.

Alguns podem perguntar: a IA já não consegue ler meus arquivos diretamente? Por que precisamos da CLI?

Aqui vai uma analogia. Seu cofre Obsidian é uma biblioteca com centenas de livros.

Sem CLI: Quando a IA precisa encontrar informações, ela só pode procurar entre as estantes, folheando livros um por um, ou depender de você dizer “vá para a terceira fileira, segundo livro.”

Com CLI: A biblioteca ganha um sistema de recuperação. A IA insere um tópico, e o sistema diz diretamente quais arquivos são relevantes, onde estão, quais palavras-chave estão nas notas — e também pode criar novos arquivos, atualizar propriedades e mover conteúdo entre pastas.

A diferença de eficiência é enorme. Quando seu cofre tem muitos arquivos, a precisão e a velocidade com que a IA encontra coisas são de níveis completamente diferentes com ou sem CLI.

Como Usar

A maneira mais simples: diga diretamente à IA para usar a CLI durante sua conversa.

Por exemplo, se você quer que a IA organize suas notas, basta dizer: “Use o Obsidian CLI para pesquisar conteúdo sobre XXX na minha pasta 01Notes/”, e a IA chamará o comando obsidian search para recuperar, em vez de escanear arquivos cegamente. Comandos comuns incluem:

Pesquisar conteúdo: obsidian search vault="OBSIDIAN_VAULT" query="palavra-chave" path="01Notes"
Ler arquivo: obsidian read vault="OBSIDIAN_VAULT" path="04Output/nome-do-arquivo.md"
Criar nota: obsidian create vault="OBSIDIAN_VAULT" path="caminho-destino.md" content="..."
Listar pasta: obsidian files vault="OBSIDIAN_VAULT" folder="04Output"

Você não precisa memorizar esses comandos; basta dizer à IA o que deseja fazer e deixá-la escolher qual comando usar.

Uma maneira ainda mais conveniente é solidificar essas operações em uma Skill. Na Skill, pré-defina quais operações devem ser feitas via CLI, e a IA seguirá automaticamente as regras da Skill, sem que você precise lembrá-la toda vez. Minha Skill de escrita para o WeChat Official Account funciona assim — ela especifica pesquisar materiais com obsidian search, gerar artigos com obsidian create e definir propriedades com obsidian property:set. Toda vez que a IA executa essa Skill, ela usa automaticamente a CLI para operar o cofre, sem instruções adicionais.

Skill: Transforme um Fluxo de Trabalho em um Único Comando

A CLI resolve o problema de “encontrar”, mas você ainda precisa declarar suas necessidades manualmente a cada vez. Se você tem um fluxo de trabalho fixo, pode escrevê-lo como uma Skill e, depois, executar todo o processo com um único comando.

Primeiro, deixe-me explicar o que é uma Skill. Simplificando, uma Skill é um script fixo que você escreve antecipadamente para a IA. Você inclui todas as regras, fluxos de trabalho e requisitos de formatação. Então, cada vez que você emite um comando, a IA executa de acordo com esse script, sem precisar de explicações repetidas. Se você já usou o Claude Code, uma Skill corresponde ao comando /skill-name.

Aqui estão alguns cenários em que uso Skills para processar arquivos do Obsidian:

Vídeo para texto: Vídeos do Bilibili ou locais, extrair áudio, transcrever para texto, organizar em notas do Obsidian e colocar diretamente na pasta de entrada.

Adicionar links bidirecionais: Depois de escrever uma nova nota, fazer a IA escanear as notas existentes e adicionar [[links bidirecionais]] ao conteúdo relacionado, tecendo a rede de informações.

Escrever artigos: Dado um tópico, a IA pesquisa materiais, confirma a direção do tópico, aprende meu estilo de escrita, escreve um rascunho, revisa e reduz a artificialidade da IA, adiciona imagens e, finalmente, gera o artigo na pasta 04Output/.

Revisão e verificação de fatos: Jogar um rascunho pronto para a IA, pedir que ela verifique parágrafo por parágrafo em busca de erros, problemas de lógica e afirmações que valham a pena verificar.

Essas tarefas costumavam ser feitas manualmente, dispersas e demoradas. Com Skills, um único comando faz a IA executar todo o processo, e você só precisa confirmar nos pontos-chave.

Conceitos sozinhos são muito abstratos. Vamos ver um exemplo concreto de uma Skill.

Criei uma Skill de escrita para o WeChat Official Account para a pasta 04Output/, cobrindo o processo completo de escrita, desde a escolha do tópico até a publicação. Veja como funciona:

Passo 1: Encontrar tópicos. A IA pode pesquisar no Reddit, Hacker News e X por tópicos recentes em alta sobre IA, finanças e tecnologia, e listar vários tópicos candidatos para você escolher.

Passo 2: Pesquisar materiais. Após confirmar o tópico, a IA automaticamente busca informações relevantes dos últimos dois anos, organiza em arquivos de base de conhecimento e os salva.

Passo 3: Discutir direção. A IA oferece de 3 a 4 ângulos de escrita e esboços correspondentes para você escolher. Você confirma antes de prosseguir.

Passo 4: Aprender estilo e escrever rascunho. Vários modos para escolher: ler seus próprios artigos publicados para aprender seu estilo, aplicar modelos de estilo de autores como Jiubian ou Huashu, ou especificar um artigo para extrair características de estilo na hora. Após aprender o estilo, escrever o rascunho.

Passo 5: Revisar. Três passagens: precisão do conteúdo, reduzir a artificialidade da IA (substituir frases como “vale a pena notar”, “capacitar”, “em resumo”) e polir detalhes de frases e parágrafos.

Passo 6: Adicionar imagens e publicar. Inserir placeholders de imagem e, se necessário, enviar diretamente para a caixa de rascunho do WeChat Official Account.

Durante todo o processo, a IA usa o Obsidian CLI para operar sua pasta: pesquisar notas existentes como materiais, salvar resumos e arquivos de base de conhecimento em diretórios especificados, gerar o artigo final em 04Output/ e definir propriedades do frontmatter. Você não precisa mover nenhum arquivo manualmente.

A captura de tela abaixo mostra como é quando eu emito um comando de escrita para a IA:

Este é apenas um exemplo para a pasta 04Output/. Você pode criar suas próprias Skills para qualquer pasta: uma Skill para organizar notas de leitura, uma Skill para resumir atas de reunião, uma Skill para revisar diários… Desde que você consiga descrever claramente “o que quero que a IA faça por mim nesta pasta”, você pode escrever como uma Skill.

Disponibilizei esta Skill de escrita para o WeChat Official Account como código aberto. Se precisar, você pode baixá-la diretamente do meu blog: https://blog.discoverlabs.ac.cn/downloads/writing-gongzhonghao-skill/

Resumo

O que você aprendeu hoje:

O método mais simples: dar diretamente o caminho do arquivo para a IA, ela pode ler e processar o arquivo original — resumo, tradução, modificação, tudo funciona
Obsidian CLI: Quando seu cofre tem muitos arquivos, a CLI dá à IA um “sistema de recuperação de biblioteca” para encontrar informações com mais precisão e rapidez
Skill: Escrever um fluxo de trabalho fixo como um script, executar todo o processo com um comando, adequado para fluxos de trabalho repetitivos

Pontos-chave:

Os três métodos aumentam em dificuldade e automação; escolha de acordo com suas necessidades
A combinação de CLI + Skill é a verdadeira integração profunda entre IA e Obsidian
Você não precisa escrever uma Skill do zero; pode pedir para a IA escrevê-la para você

Como Salvar Páginas da Web no Obsidian com o Web Clipper

Mon, 01 Jan 0001 00:00:00 +0000

Já cobrimos templates — usar variáveis para preencher automaticamente datas e títulos, e aplicar formatações com um clique ao criar novas notas. Agora vamos dar um passo adiante.

Só tomar notas não basta. Todo dia você navega no Twitter, lê artigos do WeChat e rola o Reddit. Quando encontra algo bom, como salva? Print? Vira uma imagem, não pesquisável. Copiar e colar? A formatação fica uma bagunça, e você precisa adicionar título e link manualmente. Jogar nos favoritos do navegador? Esse é o descanso eterno dos favoritos: as coisas entram mas nunca saem, e você nunca mais olha para elas.

Este capítulo resolve esse problema: como salvar conteúdo da web no Obsidian de forma rápida e limpa. A ferramenta é a extensão oficial do navegador para Obsidian — Web Clipper.

Por que usar o Web Clipper

Antes do Web Clipper, passei por três estágios de salvamento de artigos da web:

Primeiro estágio: print. Um clique, joga nas notas. Problema: prints não são pesquisáveis. Três meses depois, você não faz ideia do que capturou, muito menos consegue encontrar.

Segundo estágio: copiar e colar. Copia o texto para o Obsidian, depois adiciona manualmente o título e o link de origem. Problema: a formatação geralmente fica bagunçada — títulos viram texto normal, negrito desaparece, blocos de código viram texto simples. Leva minutos para limpar cada vez.

Terceiro estágio: favoritos. Clica na estrela do navegador, o mais fácil. O custo: você nunca mais abrirá esses links.

A lógica do Web Clipper: salvar com um clique, formatação limpa, metadados automáticos, direto no Obsidian. Título, link original, data de salvamento — tudo preenchido automaticamente. O conteúdo está em formato Markdown, as imagens são preservadas. Com o Interpretador de IA, você pode até fazer a IA resumir o conteúdo enquanto salva.

Instalação

O Web Clipper é uma extensão de navegador. Atualmente, suporta Chrome, Edge, Firefox e Safari (alguns recursos podem variar).

Importante: artigos do WeChat precisam ser abertos em um navegador primeiro; você não pode usá-los diretamente no cliente do WeChat. O cliente do WeChat é um ambiente separado que as extensões do navegador não conseguem acessar. Você precisa copiar o link, abri-lo no Chrome ou Edge e depois salvar.

Passos de Instalação

Passo 1: Usuários do Chrome abram a Chrome Web Store, pesquisem por “Obsidian Web Clipper”, encontrem a extensão oficial (ícone igual ao do Obsidian, o padrão de gema), cliquem em “Adicionar ao Chrome”.

Passo 2: Usuários do Edge abram a loja de Complementos do Edge, pesquisem por “Obsidian Web Clipper”, instalem. O Edge também pode usar a versão da Chrome Web Store, tanto faz.

Passo 3: Após a instalação, o ícone da extensão aparece na barra de ferramentas no canto superior direito. Se não estiver visível, clique no ícone de quebra-cabeça (Extensões) no extremo direito da barra de ferramentas, encontre o Obsidian Web Clipper e fixe-o na barra de ferramentas.

Instalação concluída.

Configurações Básicas

Clique no ícone da extensão na barra de ferramentas para abrir o painel de salvamento. Há um pequeno ícone de engrenagem no canto inferior direito — é a entrada de configurações. Entre nas configurações e configure o básico.

Conecte seu Cofre do Obsidian

A primeira coisa nas configurações é conectar seu Cofre. Na seção “Cofres”, clique em “Adicionar cofre”, digite o nome do seu cofre — aquele que aparece no canto inferior esquerdo do Obsidian. Por exemplo, meu cofre se chama “Obsidian Vault”, então digito isso.

Nota: Na primeira conexão, o Obsidian abrirá uma janela de autorização perguntando se você permite que o Web Clipper acesse o cofre. Selecione “Permitir” — isso é um aviso de segurança normal.

Defina a Pasta de Salvamento Padrão

Após conectar o cofre, defina o Local padrão.

É recomendado criar uma pasta de entrada dedicada, como 00-Inbox ou Inbox, especificamente para conteúdo salvo. Não jogue diretamente na raiz do cofre — com o tempo a raiz ficará bagunçada, e você não saberá quais notas estão organizadas e quais são arquivos da web não processados.

Visão Geral da Interface

Após a configuração, cada vez que você abrir a extensão, verá três áreas principais:

Topo: Área de propriedades — identifica automaticamente o título da página atual, URL, autor (se disponível)
Meio: Área de pré-visualização do conteúdo — o corpo já foi convertido para Markdown
Base: Área de ação — escolha para qual cofre e pasta salvar, selecione um template, depois clique em “Salvar”

Interpretador de IA

Este é o recurso que vale mais a pena configurar no Web Clipper.

O que é

O Interpretador de IA permite que você escreva instruções em um template e, ao salvar, clique no botão “Adicionar ao Obsidian”, e a IA processará o conteúdo especificado. Por exemplo: resumir o texto completo, extrair palavras-chave, traduzir… O que ele pode fazer depende de como você escreve o prompt.

Este recurso requer uma Chave de API. Se você já tem uma chave de API da OpenAI, DeepSeek ou Anthropic, pode usá-la diretamente; caso contrário, registre-se na respectiva plataforma.

Configuração

Vá para as configurações, encontre a aba “Interpretador”.

Passo 1: Selecione a fonte do modelo e insira a Chave de API correspondente. Suporta OpenAI, Anthropic (Claude), Ollama (modelos locais) e mais. Eu uso DeepSeek — acho que é o melhor para resumir artigos.

Passo 2: Ative “Habilitar Interpretador”, ligue esse interruptor.

Depois disso, escreva variáveis de prompt no seu template e, ao salvar, uma área do interpretador aparecerá na janela da extensão — clique para acioná-lo.

Criar Templates Personalizados

O Web Clipper vem com um template padrão — funciona, mas não é ótimo. Gaste alguns minutos criando seu próprio template, e cada salvamento será muito mais confortável.

Por que Personalizar Templates

Diferentes tipos de conteúdo exigem informações diferentes:

Artigos técnicos: você quer título, link, resumo da IA, corpo
Artigos do WeChat: você quer título, autor, data de publicação, resumo da IA
Páginas de produto: você quer título, preço, link, sem necessidade de texto completo

Um template não cobre todos os cenários. Crie alguns templates baseados no tipo de conteúdo e selecione o apropriado ao salvar — muito conveniente.

Acessar Configurações de Template

Nas configurações do Web Clipper, clique em “Novo Template” à esquerda para criar um novo. Sou preguiçoso, então uso apenas um.

Dê um nome ao template, como “Coleção de Artigos”, e comece a escrever o conteúdo.

Variáveis de Template

O Web Clipper suporta dois tipos de variáveis:

Variáveis de página — extraídas automaticamente da página web atual:

Variável	Descrição
`{{title}}`	Título da página
`{{url}}`	URL da página atual
`{{author}}`	Autor do artigo (se reconhecido)
`{{date}}`	Data de hoje
`{{content}}`	Corpo do conteúdo (formato Markdown)

Variáveis do interpretador — chamam a IA nas propriedades ou no conteúdo:

A sintaxe do interpretador é direta: coloque a instrução que você quer dar à IA entre aspas duplas, envolta em chaves duplas, assim:

{{"Summarize the full article without using an H1 heading"}}

O texto interno é sua instrução para a IA; o formato externo {{" "}} não deve ser alterado. O Web Clipper reconhece essa sintaxe e sabe que deve chamar a IA para processamento ao salvar.

Tanto propriedades quanto conteúdo podem usar isso. Se você quer que um campo de propriedade seja preenchido automaticamente pela IA, escreva esse formato no valor da propriedade; se quer inserir um resumo da IA no conteúdo, escreva lá também.

Exemplo de Template Completo

Aqui está o template que eu uso:

Propriedades do Template:

URL: {{url}}
Saved: {{date}}

Conteúdo do Template:


# Summary

Há uma coisa que vale mencionar: a linha do autor usa {{author|split:", "|wikilink|join}}, não o simples {{author}}. Isso é uma combinação de variável + filtro — primeiro divide o campo de autor por vírgula (alguns artigos reconhecem múltiplos autores), depois converte cada nome no formato de wiki-link do Obsidian [[Nome do Autor]], e finalmente junta novamente. Assim, após salvar, clicar no nome do autor leva à nota correspondente. Você não precisa usar isso; {{author}} gerando texto simples funciona perfeitamente, depende da sua preferência.

Para a área de conteúdo, deixei apenas duas linhas em branco: Categoria do Tópico/Link para adicionar informações relacionadas manualmente, e # Resumo como um espaço reservado para título — se você tiver o interpretador ativado, pode adicionar {{"Resuma o artigo completo sem usar um título H1"}} abaixo dele para deixar a IA preencher o conteúdo automaticamente; se não, pode escrever algumas frases manualmente após salvar.

Prática: Salvando um Artigo

Todas as configurações estão prontas, vamos usar de verdade.

Suponha que você veja um artigo do WeChat que gostou e queira salvá-lo.

Passo 1: Copie o link e abra-o em um navegador. No artigo do WeChat, toque no menu do canto superior direito e selecione “Abrir no navegador padrão”.

Passo 2: Clique no ícone do Web Clipper. O ícone de gema na barra de ferramentas do canto superior direito, clique para abrir o painel de salvamento.

Passo 3: Verifique as propriedades. O painel reconhecerá automaticamente o título e a URL do artigo. Se o campo de autor não for reconhecido, preencha manualmente. A data é a de hoje, não precisa alterar.

Passo 4: Selecione um template. Escolha o template “Coleção de Artigos” que você criou. Se você tiver o interpretador de IA ativado, verá uma animação de rotação — a IA está gerando o resumo, aguarde terminar.

Passo 5: Clique em “Adicionar ao Obsidian”. Um segundo depois, abra o Obsidian, vá para sua pasta de entrada, e o artigo está lá. Título, link, data, resumo da IA — tudo presente, e o conteúdo é Markdown limpo.

Resumo

O que você aprendeu hoje:

O Web Clipper é a extensão oficial do navegador para Obsidian que salva páginas da web como notas do Obsidian com um clique, formatação limpa e metadados automáticos.
Artigos do WeChat devem ser abertos em um navegador para serem salvos; não podem ser usados no cliente do WeChat.
O Interpretador de IA requer uma Chave de API; uma vez configurado, pode gerar automaticamente resumos e extrair informações durante o salvamento.
Templates personalizados = variáveis de propriedade + prompts de IA; templates diferentes para tipos de conteúdo diferentes tornam o salvamento mais eficiente.

Pontos-chave:

Crie uma pasta de entrada dedicada; não jogue o conteúdo salvo diretamente na raiz do cofre.
Primeiro faça o fluxo funcionar com o template padrão, depois gaste tempo personalizando — templates podem ser alterados a qualquer momento; começar é mais importante.
Resumos de IA são um bônus, não uma necessidade — você pode salvar normalmente sem uma Chave de API; só perde a etapa de processamento da IA.

Crie Seu Primeiro Cofre no Obsidian

Mon, 01 Jan 0001 00:00:00 +0000

Agora que você sabe o que é o Obsidian e por que ele é recomendado, vamos começar criando seu primeiro cofre.

O que é um Cofre?

Ao abrir o Obsidian, ele pede que você selecione ou crie um Cofre.

O que é um cofre? De forma simples, é uma pasta. Todas as suas notas, anexos e configurações ficam armazenados nessa pasta. Um cofre = um espaço de notas independente. Você pode pensar nele como cadernos separados.

Se você abrir essa pasta no seu computador, verá vários arquivos .md e subpastas, como qualquer outra pasta. O Obsidian apenas adiciona uma interface bonita e recursos poderosos sobre essa pasta.

Por que Criar Vários Cofres?

O Obsidian permite criar vários cofres. Você pode perguntar: por que não colocar tudo em um único cofre?

Você pode colocar tudo em um único cofre e, para a maioria das pessoas, um cofre é suficiente. Mas existem cenários onde cofres separados fazem sentido:

Escrevendo um romance: um cofre por romance. Assim, as backlinks e tags são específicas daquele romance e não se misturam com outras notas.
Separar trabalho e vida pessoal: um cofre para notas de trabalho, outro para notas pessoais. Ao mudar de emprego, você pode excluir o cofre de trabalho sem afetar o conteúdo pessoal.
Cenários compartilhados: cofre compartilhado da família, cofre de projeto de equipe, isolado das notas pessoais.

Recomendação para iniciantes: comece com um cofre. Quando você se sentir confortável e sentir necessidade de dividir, poderá fazer isso depois.

Eu pessoalmente uso um único cofre principal, com pastas para organizar diferentes tipos de conteúdo: caixa de entrada, notas, modelos, saída, arquivo… um cofre cuida de tudo.

Como Criar um Cofre

Usuários do Ecossistema Apple (Recomendado)

Se você usa iPhone/iPad e Mac, aqui está a maneira mais fácil:

Passo 1: Crie o cofre no seu celular ou iPad.

Abra o Obsidian no iOS, toque em “Criar novo cofre”, dê um nome. O segredo é — escolha a sincronização do iCloud por padrão, assim seu cofre é automaticamente armazenado no iCloud Drive. Passo 2: Abra no seu Mac.

Abra o Obsidian no Mac, selecione “Abrir cofre existente”, encontre a pasta do cofre que você acabou de criar no iCloud Drive e abra. Por que fazer assim? Porque um cofre criado no iOS é automaticamente colocado na pasta do Obsidian no iCloud Drive, e a sincronização é ativada por padrão, sem necessidade de configuração manual. Se você criar no Mac primeiro, teria que mover manualmente a pasta para o diretório do iCloud, adicionando uma etapa extra.

Uma vez configurado, as notas escritas no celular sincronizam instantaneamente com o Mac, e as alterações feitas no Mac aparecem imediatamente no celular.

Usuários Windows / Android

Abra o Obsidian, clique em “Criar novo cofre” e escolha um local que você possa encontrar facilmente.

Se quiser sincronização entre dispositivos, coloque a pasta do cofre em um diretório de sincronização do OneDrive. Mesmo princípio do iCloud — basicamente, coloque a pasta em um diretório de nuvem e deixe a nuvem cuidar do resto.

Como é a Interface do Obsidian?

Depois que o cofre for criado, abra-o e você verá a interface. Não se intimide — é simples, com três áreas principais:

Barra Lateral Esquerda: Gerenciamento de Arquivos

A coluna mais à esquerda contém botões de atalho — pesquisa, visualização de grafo, nota diária, etc. São entradas rápidas fornecidas por plugins, que veremos mais adiante.

Ao lado está a lista de arquivos, idêntica à estrutura de pastas do seu computador. Você pode criar novas pastas, novas notas e arrastar para reordenar.

Você pode organizar notas com pastas, assim como gerenciar arquivos no computador. Por exemplo, meu cofre está dividido assim:

00 Inbox — material temporário jogado aqui
01 Notes — notas formais
04 Output — artigos finalizados
05 Archive — usado com pouca frequência, mas mantido

Você não precisa copiar minha estrutura — organize de acordo com seus próprios hábitos. O segredo é: não se prenda à categorização, apenas comece a escrever.

Centro: Área do Editor

É aqui que você escreve notas, e onde passará a maior parte do tempo.

Abra uma nota (ou crie uma nova) e comece a escrever diretamente. Toda a sintaxe Markdown que você aprendeu funciona aqui — # para títulos, ** para negrito, - para listas, [[]] para backlinks.

Acima do editor, há um caminho de arquivo mostrando em qual pasta a nota atual está.

Barra Lateral Direita: Painel de Informações

A barra lateral direita fica recolhida por padrão. Quando aberta, você verá várias abas:

Backlinks: mostra quais notas referenciam a nota atual (o núcleo das backlinks)
Tags: lista de tags na nota atual
Outline: sumário gerado automaticamente com base nos níveis de título, fácil para navegação

Você pode não usar o painel direito no início. Tudo bem — conforme suas notas crescerem e você começar a usar backlinks, o painel de backlinks se tornará muito útil.

Escreva Sua Primeira Nota

Clique em “Nova nota” no canto superior esquerdo (ou pressione Ctrl/Cmd + N), e uma nota em branco aparece.

Dê um título a ela e comece a escrever. Por exemplo:

# My First Obsidian Note

Started using Obsidian today.

## Why Obsidian
- Data is in my own hands
- Supports Markdown
- Works well with AI

## Today's Plan
- [ ] Familiarize with the interface
- [ ] Write the first note
- [x] Install Obsidian

Depois de escrever, a nota é salva automaticamente — não precisa pressionar Ctrl+S, o Obsidian salva em tempo real.

Conecte Suas Notas com Backlinks

Apresentamos o conceito de backlinks anteriormente; agora vamos ver como usá-las.

Vincular a uma nota inteira: Digite [[ e o Obsidian mostrará automaticamente uma lista de notas para escolher. Selecione uma e uma backlink é criada; clique nela para pular para aquela nota.

Today I read [[Feynman Learning Method]], the core idea is to test yourself by teaching others.

Vincular a uma seção específica: Se você não quiser vincular a nota inteira, mas apenas uma seção sob um título, adicione # após o nome da nota e selecione o título:

See [[Feynman Learning Method#Specific Steps]], the first step is to choose a concept.

Clicar neste link pulará diretamente para o título “Passos Específicos” na nota “Método Feynman de Aprendizagem”.

Isso é especialmente útil para organizar conhecimento e conceitos. Por exemplo, se você está estudando economia, pode criar notas separadas para “PIB”, “Inflação” e “Taxa de Juros”, depois usar backlinks para referenciá-las sempre que usar esses conceitos. Com o tempo, seu cofre se torna sua própria enciclopédia pessoal — cada conceito tem uma explicação, os conceitos estão interconectados, e você pode clicar para pular e revisar.

Modo de Edição vs. Modo de Leitura

Você pode notar um botão de alternância (ícone de livro) no canto superior direito que alterna entre duas visualizações:

Modo de Edição: Você vê todos os símbolos Markdown. #, **, - [ ] são exibidos como estão. Bom para escrever.

Modo de Leitura: Os símbolos Markdown são renderizados em formatação real. Os títulos ficam maiores e em negrito, o texto em negrito fica realmente em negrito, as listas se tornam listas bonitas. Bom para ler.

Há também um estado intermediário chamado Live Preview — ele renderiza enquanto você escreve. A linha onde está o cursor mostra Markdown bruto, enquanto as outras linhas são renderizadas. Recomendado para iniciantes, pois equilibra edição e leitura.

Em Configurações → Editor → Modo de edição padrão, você pode escolher “Live Preview” ou “Modo fonte”. Recomendo selecionar “Live Preview”.

Como Inserir Imagens

As notas frequentemente precisam de imagens. Inserir imagens no Obsidian é muito simples:

Método 1: Colagem direta. Após tirar um print, pressione Ctrl/Cmd + V para colar no editor, e a imagem é inserida.

Método 2: Arrastar e soltar. Arraste um arquivo de imagem de uma pasta diretamente para o editor.

Após a inserção, você verá algo assim no editor:

![[screenshot-2026-02-27.png]]

Esta é a sintaxe de imagem do Obsidian — como backlinks, usa ![[]] para envolver o nome do arquivo. No Modo de Leitura, a imagem é exibida normalmente.

Onde as Imagens São Armazenadas?

Este é um ponto comum de confusão para iniciantes. Quando você cola uma imagem, o Obsidian a salva automaticamente na pasta de anexos especificada.

Por padrão, as imagens são jogadas no diretório raiz do cofre, o que pode ficar bagunçado com o tempo. Recomenda-se configurar uma pasta de anexos dedicada para armazenar todas as imagens, áudios, PDFs e outros anexos em um só lugar.

Configurações Recomendadas de Anexos

Abra Configurações → Arquivos & Links e configure da seguinte forma:

Configuração	Valor Recomendado	Descrição
Local padrão para novas notas	Pasta especificada para anexos	Novas notas são colocadas em uma pasta designada
Pasta para armazenar novas notas	`00 Inbox`	Novas notas vão para a caixa de entrada primeiro, depois são categorizadas
Caminho padrão de anexos	Pasta especificada para anexos	Imagens e outros anexos são gerenciados uniformemente
Caminho da pasta de anexos	`05 Archive/Assets`	Todas as imagens, áudios, PDFs são armazenados aqui

Seção Links:

Configuração	Valor Recomendado	Descrição
Tipo de link interno	Forma mais curta possível	Caminhos de backlink são mais concisos
Sempre atualizar links internos	Ativado	Atualiza automaticamente todas as referências ao renomear arquivos, sem medo de renomear
Usar links Wiki	Ativado	Usa sintaxe `[[]]`, mais conveniente que links Markdown padrão

Após essa configuração, seu cofre permanece organizado — notas e anexos têm seus lugares, sem mistura.

Solução Melhor: Serviço de Hospedagem de Imagens

Mas, honestamente, armazenar imagens em uma pasta de anexos local não é a solução ideal.

Por quê? Porque quando você quiser publicar seu artigo em contas públicas do WeChat, blogs ou outras plataformas, as imagens locais não podem ser enviadas — você teria que reenviar e reinserir manualmente cada uma. Com muitos artigos, isso se torna muito doloroso.

Uma abordagem melhor é usar um serviço de hospedagem de imagens — envie as imagens para a web, obtenha uma URL e referencie essa URL diretamente no Markdown. Dessa forma, não importa em qual plataforma você publique, as imagens são exibidas diretamente sem processamento extra.

<!-- Local attachment method -->
![[screenshot-2026-02-27.png]]

<!-- Image hosting method -->
![](https://cf-img.discoverlabs.ac.cn/202602272b6a153c41f15fd574a6c29c2ae4a4e2.webp)

Claro, usar um serviço de hospedagem de imagens significa que suas imagens são enviadas para a web, então fique atento à privacidade — não envie capturas de tela contendo informações sensíveis.

A configuração específica e o uso de serviços de hospedagem de imagens serão abordados no capítulo final deste tutorial. Por enquanto, apenas saiba que existe.

Resumo

O que você aprendeu hoje:

O que é um cofre: é uma pasta onde todas as suas notas são armazenadas.
Por que criar vários cofres: a maioria das pessoas precisa apenas de um; divida para romances, trabalho ou cenários compartilhados.
Como criar um cofre: usuários Apple recomendados a criar no iPhone (sincronização automática com iCloud); outros colocam em um diretório de nuvem.
Três áreas da interface: barra lateral esquerda para gerenciamento de arquivos, editor central, barra lateral direita para informações.
Primeira nota: Ctrl/Cmd+N para criar, escrever em Markdown, salvar automaticamente.
Duas visualizações: Modo de Edição mostra símbolos, Modo de Leitura mostra saída renderizada; Live Preview recomendado.
Inserir imagens: colar ou arrastar e soltar; configure uma pasta de anexos para manter o cofre organizado.

Principais conclusões:

Não se prenda à categorização, apenas comece a escrever.
Um cofre é suficiente, divida quando necessário.
Recomendado: modo Live Preview, bom tanto para escrever quanto para ler.

CSS Personalizado: Faça o Obsidian Parecer Seu

Mon, 01 Jan 0001 00:00:00 +0000

Já falamos sobre configurações de temas antes, e o Obsidian fica muito melhor depois de instalar um tema. Mas muitas pessoas ainda sentem que algo está errado após trocar de tema — fonte muito pequena, espaçamento entre linhas muito apertado, área de notas muito estreita… Esses detalhes estão além do escopo dos temas. Este capítulo abordará como ajustar finamente com CSS Snippets.

Este capítulo cobre quatro coisas:

O que é CSS — compreensível mesmo sem conhecimento de programação
Por que você ainda precisa de CSS mesmo com um tema
Deixe a IA escrever CSS para você — basta copiar e colar
Onde colocar o CSS e como fazê-lo funcionar

O que é CSS

CSS significa Cascading Style Sheets (Folhas de Estilo em Cascata). Parece técnico, mas a lógica central é simples: CSS é um conjunto de regras que controlam a aparência das coisas.

Por exemplo:

Qual fonte, tamanho e cor este texto deve ter?
Qual a largura desta área? Quais as margens?
Qual deve ser a cor de fundo ao passar o mouse?

Quase todos os efeitos visuais que você vê em uma página da web são controlados por CSS. A interface do Obsidian também é construída sobre tecnologia web (Electron), então CSS pode ser usado para controlar sua aparência também.

O tema que você instala é essencialmente um grande pacote de CSS escrito por outra pessoa. Um CSS Snippet é um pequeno pedaço de CSS que você mesmo adiciona, especificamente para ajustar coisas que o tema não cobre.

O tema é o estilo geral; os snippets são ajustes locais. Eles não entram em conflito e podem ser usados juntos.

Por que ainda preciso de CSS mesmo com um tema?

Os temas resolvem o problema do “estilo geral”, mas muitos detalhes de preferência pessoal estão além do escopo dos temas — e nem deveriam estar, porque as preferências de cada um são diferentes.

Vários cenários comuns onde os temas falham:

Área de notas muito estreita: Muitos temas limitam a largura máxima das notas por padrão, deixando grandes espaços em branco em telas largas, com o conteúdo espremido no meio. Alguns gostam desse layout, outros acham um desperdício.

Espaçamento entre linhas muito apertado/solto: O espaçamento padrão entre linhas pode não ser confortável para você, mas o tema não tem uma opção para isso.

Cor do título não adequada: Você gosta do tema no geral, mas a cor do H1 está um pouco brilhante demais e você quer escurecê-la.

Elemento irritante da interface: Por exemplo, um botão que você nunca usa — você quer escondê-lo.

Essas necessidades são muito específicas e pessoais. Os CSS Snippets são a ferramenta projetada para resolver esses problemas de “última milha”.

Não precisa escrever você mesmo — deixe a IA escrever para você

Este é o ponto mais importante deste capítulo: Você não precisa aprender CSS — apenas deixe a IA escrever para você.

O processo é muito simples: basta dizer à IA o que você quer mudar:

“Escreva um CSS Snippet do Obsidian para definir a largura máxima da área de conteúdo da nota como 900px”

“Escreva um CSS Snippet do Obsidian para definir o espaçamento entre linhas do corpo como 1.8”

“Escreva um CSS Snippet do Obsidian para mudar a cor do H1 para azul escuro”

A IA lhe dará um trecho de código CSS completo que você pode copiar e usar diretamente.

Algumas dicas para obter melhores resultados da IA:

Especifique que é um CSS Snippet do Obsidian, caso contrário a IA pode lhe dar CSS web comum com nomes de variáveis incorretos.
Peça à IA para adicionar comentários, diga “Por favor, adicione comentários ao lado de cada propriedade explicando o que ela faz” para que você possa entender seu arquivo depois.
Mude uma coisa de cada vez, um arquivo de snippet para cada coisa — mais fácil de depurar e desativar individualmente.

Exemplo de conversa:

Me: Write me an Obsidian CSS Snippet to set the maximum width of the note content area to 900px, please add comments.

AI:
.markdown-source-view, .markdown-reading-view {
  /* Limit the maximum width of the note content area */
  --file-line-width: 900px;
}

É isso. Não precisa entender sintaxe CSS, não precisa consultar documentação. Descreva o que você quer, obtenha o código, cole, pronto.

Onde colocar o CSS? Como fazê-lo funcionar?

Os CSS Snippets têm um local de armazenamento fixo. Basta seguir estes passos.

Passo 1: Encontre a pasta de snippets

Caminho: Raiz do seu Vault → pasta .obsidian → pasta snippets

.obsidian é uma pasta oculta. No Mac, pressione Command + Shift + . para mostrar arquivos ocultos. Se a pasta snippets não existir, crie uma manualmente.

Claro, você também pode acessá-la diretamente pelas Configurações.

Passo 2: Crie um arquivo .css

Na pasta snippets, crie um novo arquivo de texto, mude a extensão para .css. Nomeie como quiser, mas é recomendado usar um nome descritivo como note-width.css ou line-height.css. Cole o código da IA nele e salve.

Alternativamente, você pode abrir esta pasta e deixar a IA escrever o arquivo CSS diretamente lá.

Passo 3: Ative no Obsidian

Caminho: Configurações → Aparência → CSS snippets

Role até o final da página, você verá uma seção “CSS snippets”. Clique no ícone de atualização à direita, e o arquivo que você acabou de criar aparecerá na lista. Clique no botão de alternância ao lado do nome do arquivo, a alternância muda de cor e o snippet entra em vigor. A interface muda imediatamente, sem necessidade de reiniciar. Se o efeito não estiver certo, desligue a alternância e volte para verificar o código.

Como eu uso CSS pessoalmente

Aqui estão alguns snippets que eu realmente uso, para referência.

Alargar área de notas – Este é o que mais uso — define a largura máxima da área de conteúdo da nota mais larga, para que haja menos espaço em branco em telas grandes.

Ajustar espaçamento entre linhas – O espaçamento padrão entre linhas é um pouco apertado para mim, então uso CSS para aumentá-lo ligeiramente para uma leitura mais confortável.

Ocultar elementos não utilizados – Existem alguns botões e ícones na interface do Obsidian que nunca uso. Eu os defino como display: none com CSS para ocultá-los, deixando a interface mais limpa.

Ajustes de estilo de callouts – Não gostei das cores padrão dos blocos de callout em um certo tema, então usei CSS para mudá-las para cores mais suaves.

Esses quatro snippets são armazenados em quatro arquivos .css separados, cada um pode ser ativado individualmente. Se depois de um tempo você achar que um não se adequa, basta desligá-lo — eles não interferem entre si.

Resumo

O que você aprendeu hoje:

CSS é a regra para controlar a aparência da interface; o Obsidian usa CSS Snippets para ajustes locais.
Temas são estilos gerais; snippets são ajustes de detalhes — eles funcionam juntos.
Não precisa escrever CSS você mesmo; diga à IA o que você quer mudar e copie o código que ela lhe der.
Caminho de armazenamento dos snippets: Raiz do Vault → .obsidian/snippets/ → arquivo .css.
Ative em Configurações → Aparência → CSS snippets, ative a alternância para ativar.

Principais conclusões:

Descrever suas necessidades para a IA escrever CSS é muito mais eficiente do que aprender sintaxe CSS você mesmo.
Um snippet faz uma coisa, facilitando o gerenciamento e a depuração.
As alternâncias podem ser desligadas a qualquer momento — seguro e reversível, sem necessidade de se preocupar em quebrar a interface.

Estrutura de Pastas: Um Fluxo de Trabalho Zettelkasten Local

Mon, 01 Jan 0001 00:00:00 +0000

Depois de cobrir o plugin de diário — que usa entrada de voz para reduzir a barreira e envia entradas acumuladas para revisão por IA — este capítulo aborda um obstáculo comum após instalar o Obsidian: como organizar suas pastas.

Por que planejar sua estrutura de pastas

Sem um plano, o resultado típico é: quando você começa a usar o Obsidian, cria pastas casualmente como “Trabalho”, “Estudo”, “Leitura”, “Temporário”… Conforme você cria mais e mais, não consegue lembrar onde colocou as coisas, então acaba pesquisando toda vez, tornando as pastas inúteis.

Ou você vai para o outro extremo: gastar muito tempo projetando hierarquias como “Trabalho/Projeto A/Notas de Reunião/2026/Q1”… É meticulosamente planejado, mas depois de dois meses você acha o custo de manutenção muito alto. Você não sabe onde colocar coisas novas, e tudo acaba amontoado no diretório raiz.

O objetivo do planejamento de pastas não é fazer seu cofre parecer organizado, mas tornar tanto o armazenamento quanto a busca suaves.

Visão geral dos métodos populares

Antes de apresentar minha própria abordagem, vamos dar uma olhada rápida em dois métodos conhecidos — só para você saber que eles existem.

PARA

PARA é um método do blogueiro de produtividade Tiago Forte, com quatro pastas: Projects (projetos em andamento), Areas (responsabilidades de longo prazo), Resources (materiais de referência) e Archives (arquivos).

A lógica é clara e é bastante popular. O problema é que os limites são difusos — você muitas vezes não tem certeza se algo pertence a Areas ou Resources. Descobrir leva tempo e, com o tempo, é fácil desistir.

Zettelkasten

Inventado pelo sociólogo alemão Niklas Luhmann, a ideia central é: cada nota captura uma única ideia, identificada por um número, e conectada por links para formar uma rede. Não depende de classificação por pastas, mas de conexões entre notas.

É ótimo para acúmulo profundo de conhecimento, mas a barreira de entrada é alta e os custos de manutenção não são baixos. Não é adequado como estrutura principal para o fluxo de trabalho diário.

Minha abordagem: 5 pastas + 1 regra

Sem necessidade dessa complexidade. Aqui está uma estrutura que considero suficiente e fácil de manter.

Estrutura de pastas

00-Inbox/
01-Notes/
02-Templates/
04-Output/
07-Diary/

Você também pode criar pastas de projeto conforme necessário, como “08-Reforma” ou “09-Aprendendo-Inglês”, e arquivá-las ou excluí-las quando terminar.

00-Inbox: Tudo entra primeiro

Esta é a porta de entrada de todo o sistema.

Recortes do navegador, ideias transcritas por voz, anotações aleatórias, materiais não processados — jogue tudo na caixa de entrada primeiro, não importa o que seja.

Não perca tempo categorizando ao coletar. Apenas coloque primeiro. O valor da caixa de entrada é reduzir o atrito no registro: você não precisa pensar “onde isso deve ir”, apenas coloque.

Mas a caixa de entrada tem uma regra de ouro: as coisas que entram devem ser processadas regularmente.

A cada poucos dias (ou semanalmente), revise a caixa de entrada e classifique os itens em seus lugares adequados — notas vão para notas, exclua o desnecessário e mova coisas a serem transformadas em artigos para a pasta de saída.

A caixa de entrada não é um depósito; não pode acumular indefinidamente. Se você tem itens de três meses atrás ainda intocados na sua caixa de entrada, significa que esse fluxo de trabalho ainda não está funcionando.

01-Notes: Sem categorias, layout plano

Esta é a maior diferença das abordagens tradicionais em todo este sistema.

Na pasta de notas, não crie subpastas; todas as notas são dispostas de forma plana em uma única camada.

Notas de livros, atas de reuniões, conceitos aprendidos, extensões de uma ideia — tudo junto, sem separação por tópico, sem ordenação por tempo, apenas uma grande camada plana.

Por que fazer isso?

Porque na era da IA, a busca é mais importante que a classificação. Quer você coloque uma nota em “Economia/Macro/Política Monetária” ou no diretório raiz, não faz diferença para a busca por IA. A IA encontra coisas entendendo o conteúdo, não por caminhos de pastas.

E o tempo que você gasta em classificação manual é puro custo de manutenção — tempo pensando onde colocar, lembrando onde colocou e depois não encontrando.

Com layout plano, encontrar notas depende da busca. A IA pode fazer busca em texto completo, o que é muito mais confiável do que você lembrar “acho que está em alguma subpasta”.

04-Output: Conteúdo para públicos externos

Esta pasta contém conteúdo que você escreve para públicos externos: artigos para WeChat, postagens de blog, relatórios formais, documentos organizados para outros.

A diferença da pasta de notas é o público. Notas são para você; não precisam ser completas ou bonitas, apenas registradas. Output é para outros verem, ou conteúdo completo que você quer preservar.

Separar tem um benefício: quando você abre a pasta de saída, vê conteúdo relativamente completo, sem ser perturbado por rascunhos e fragmentos.

07-Diary: Separado, não misture com notas

O diário vai em uma pasta separada.

As entradas do diário são arquivos gerados por data, e seu número cresce linearmente com o tempo. Como mencionado anteriormente, é recomendado definir um caminho de armazenamento no plugin de diário para mantê-los em um lugar dedicado.

A razão para separar das notas é simples: o caso de uso do diário é diferente das notas. Diários são navegados cronologicamente, notas são pesquisadas por palavras-chave. Misturá-los interferiria um no outro.

Pastas de projeto: Crie conforme necessário, arquive quando terminar

Reforma, mudança de emprego, aprender uma habilidade — coisas com um limite de tempo claro podem ter sua própria pasta, colocando todos os arquivos relacionados juntos para visualização centralizada fácil.

Após a conclusão do projeto, arquive ou exclua a pasta. Não deixe ocupar espaço para sempre e se tornar outro monte de bagunça.

Por que o layout plano é melhor na era da IA

A lógica tradicional de classificação por pastas é baseada em “navegação manual” — você precisa da estrutura de pastas para lembrar onde as coisas estão, então classifica e constrói hierarquias.

Mas agora é diferente.

A busca em texto completo do Obsidian + a compreensão semântica da IA já podem cobrir a maioria dos cenários de “encontrar coisas”. Você pode não lembrar o nome do arquivo de uma nota, mas lembra aproximadamente do que se trata — isso é suficiente. Pesquise algumas palavras-chave ou deixe a IA encontrar para você.

Sob essa premissa, o benefício marginal da classificação detalhada se torna muito pequeno, mas o custo de manutenção permanece.

Quanto mais complexa a estrutura de pastas, mais significa:

Você tem que pensar um passo a mais ao colocar algo (onde isso vai?)
Você esquece onde colocou depois de um tempo
O sistema se torna inconsistente, com algumas coisas flutuando fora da estrutura

Por outro lado, quanto mais simples a estrutura, menor o custo de manutenção e maior a chance de continuar com ela. Um sistema simples que funciona consistentemente é muito mais valioso do que um sofisticado que é abandonado no meio do caminho.

Resumo

O que cobrimos hoje:

Propósito central do planejamento de pastas: tornar tanto o armazenamento quanto a busca suaves, não por aparência
Métodos populares para conhecer: PARA e Zettelkasten têm seus casos de uso, mas os custos de manutenção são altos para usuários comuns
Minha abordagem: 5 pastas + 1 regra:
- 00-Inbox: tudo entra primeiro, processe regularmente
- 01-Notes: layout plano, sem categorias
- 04-Output: conteúdo completo para públicos externos
- 07-Diary: separado, não misture com notas
- Pastas de projeto: crie conforme necessário, arquive quando terminar
A regra de ouro da caixa de entrada: as coisas que entram devem ser processadas regularmente, sem acúmulo infinito

Principais conclusões:

Na era da IA, a busca é mais importante que a classificação — coloque notas de forma plana e deixe a IA encontrá-las, mais eficiente do que manutenção manual de hierarquias
Quanto mais simples o sistema, mais fácil continuar com ele — uma estrutura simples que funciona supera uma sofisticada, mas abandonada
A caixa de entrada é um ponto de entrada, não um depósito — esvaziamento regular mantém todo o fluxo de trabalho funcionando

Excalidraw no Obsidian: Diagramas Desenhados à Mão nas Notas

Mon, 01 Jan 0001 00:00:00 +0000

Como mencionado anteriormente, os arquivos Canvas estão no formato .canvas e existem separadamente dos arquivos .md — eles precisam ser gerenciados de forma independente e não podem ser combinados com anotações no mesmo arquivo. Este capítulo apresenta uma ferramenta que resolve esse ponto de dor: o plugin Excalidraw.

O que é Excalidraw e como é diferente do Canvas?

O que é Excalidraw?

Excalidraw é uma ferramenta de desenho online gratuita e de código aberto com uma versão web independente (excalidraw.com) que você pode usar diretamente no navegador sem precisar se cadastrar. Seu estilo de desenho à mão é perfeito para fluxogramas, mapas mentais, diagramas de arquitetura e conteúdos similares.

No Obsidian, usamos a versão do plugin de terceiros — mantida por desenvolvedores da comunidade, não oficialmente pelo Obsidian, então precisa ser instalada manualmente. As funcionalidades principais são as mesmas da versão web, mas com integração mais profunda com o Obsidian.

Diferenças do Canvas

Ambos parecem “desenhar em uma tela”, mas o formato do arquivo é completamente diferente, o que é a diferença central:

Canvas: Gera um arquivo .canvas. Este é um arquivo JSON independente que existe separadamente das suas notas .md e precisa ser gerenciado de forma independente.
Excalidraw: Os dados do desenho podem ser comprimidos e incorporados ao final de um arquivo .md — um único arquivo, texto e desenho coexistem, sem necessidade de gerenciamento separado.

As duas capturas de tela abaixo são do mesmo arquivo:

É por isso que recomendo o Excalidraw: quando você abre um arquivo, vê o texto; com um toque, vê o desenho. Ambos os tipos de conteúdo em um só lugar.

Instalando o Plugin Excalidraw

Excalidraw é um plugin de terceiros e precisa ser instalado manualmente.

Caminho: Configurações → Plugins de terceiros → Plugins da comunidade → Pesquisar por “Excalidraw” → Instalar → Ativar

Após a instalação, ative o plugin e você verá um ícone do Excalidraw aparecer na barra lateral esquerda.

Criando e Usando Excalidraw

Como Criar um Novo Arquivo

Existem duas maneiras:

Paleta de Comandos: Cmd+P (Mac) ou Ctrl+P (Windows), pesquise por “Excalidraw: New Drawing”, pressione Enter.
Barra Lateral Esquerda: Clique no ícone do Excalidraw para criar um novo diretamente.

Por padrão, um novo arquivo é criado como .excalidraw (não .md). Não se preocupe — como torná-lo parte de um arquivo .md é o foco da seção “Dois em Um” mais adiante.

Operações Comuns e Atalhos

Na barra de ferramentas do Excalidraw, cada ferramenta tem um número exibido abaixo — esse é o atalho. Pressione o número para alternar ferramentas diretamente, sem clicar na barra:

Ferramenta	Atalho
Seleção	1
Retângulo	2
Losango	3
Elipse	4
Seta	5
Linha	6
Desenho livre	7
Texto	8
Borracha	0
Mover tela	Espaço + arrastar, ou arrastar com botão do meio do mouse
Zoom na tela	Ctrl/Cmd + roda do mouse
Ajustar à tela	Shift+1
Selecionar tudo	Ctrl/Cmd + A
Desfazer	Ctrl/Cmd + Z

Um recurso extra em comparação com o Canvas: Excalidraw tem uma ferramenta Desenho livre dedicada (atalho 7) que permite desenhar livremente com o mouse ou trackpad — algo que o Canvas não consegue fazer.

Fluxo de Trabalho com Teclado: Desenhando sem Sair do Teclado

Excalidraw também suporta um fluxo de trabalho puro com teclado, ótimo para criar nós rapidamente, conectá-los e escrever conteúdo:

Navegação Básica (no modo Seleção):

Ação	Atalho
Selecionar próximo/anterior elemento	Tab / Shift+Tab
Mover elemento selecionado	← → ↑ ↓
Iniciar edição de texto	Enter (quando um elemento de texto está selecionado)
Sair da edição, voltar à seleção	Esc
Duplicar elemento selecionado	Ctrl/Cmd + D
Excluir elemento selecionado	Backspace ou Delete
Selecionar tudo	Ctrl/Cmd + A

Adicionando Conteúdo à Tela

Formas e Texto: Selecione uma forma na barra de ferramentas e clique na tela para desenhá-la. Com a ferramenta de texto, clique e comece a digitar — suporte a chinês.

Conexões com Setas: Quando um retângulo está selecionado, passar o mouse sobre sua borda revela pontos de conexão verdes. Arraste uma seta de um desses pontos para outra forma, e ela se encaixará.

Notas Existentes: Arraste notas diretamente da árvore de arquivos do Obsidian para a tela do Excalidraw — elas serão incorporadas como cartões de pré-visualização de notas.

Imagens: Arraste arquivos de imagem para a tela para exibi-los diretamente.

Ponto Chave! Desenhando Excalidraw com IA

Semelhante à seção “Desenhando Canvas com IA” anterior, Excalidraw também pode ser gerado diretamente pelo Claude Code.

Contexto

Apresentamos anteriormente o Claude Code e o sistema de Skills. O Canvas usa a Skill json-canvas, e o Excalidraw também tem uma Skill dedicada: excalidraw-diagram. Claro, existem muitos MCPs e Skills em torno do Excalidraw — você pode escolher o que precisar.

Foi criada por axtonliu e é de código aberto no GitHub:

https://github.com/axtonliu/axton-obsidian-visual-skills/tree/main/excalidraw-diagram

Após o download, coloque-a no diretório ~/.claude/skills/, como as outras Skills.

Esta Skill gera arquivos .excalidraw independentes, adequados para cenários onde você só precisa do desenho e não quer misturá-lo com o texto da nota.

Se você quiser incorporar o desenho diretamente dentro de um arquivo .md (o formato dois em um descrito posteriormente), escrevi uma Skill estendida: obsidian-excalidraw, especificamente para esse propósito — o resultado é comprimido e incorporado ao final do arquivo .md, sem criar arquivos extras. As duas Skills servem a propósitos diferentes; escolha conforme necessário.

Como Usar

No Claude Code, digite /excalidraw-diagram, selecione esta Skill, pressione Tab, então descreva o que deseja desenhar. O Claude Code gerará o arquivo Excalidraw correspondente.

Demonstração ao Vivo

Usei o conteúdo deste capítulo como demonstração — disse ao Claude Code: “Desenhe um fluxograma da estrutura de capítulos deste conteúdo do Excalidraw, mostrando as relações entre as seções.”

O Claude Code leu o conteúdo e gerou automaticamente um diagrama de estrutura, incorporado diretamente ao final do arquivo .md. Mude para o modo Excalidraw para vê-lo. Não é necessário arrastar nós ou conectar linhas manualmente — muito mais rápido do que desenhar à mão.

Ponto Chave! Incorporando Excalidraw em Arquivos .md (Dois em Um)

Vamos ser claros: Por padrão, o plugin Excalidraw cria arquivos .excalidraw, que são separados dos arquivos .md e precisam ser gerenciados de forma independente, assim como o Canvas.

O recurso “dois em um” não é o comportamento padrão; requer configuração adicional. Uma vez configurado, novos arquivos serão no formato .md, com os dados do desenho comprimidos e armazenados ao final do arquivo, de modo que ambos coexistem no mesmo arquivo.

O Canvas não consegue fazer isso, mas o Excalidraw consegue — após a configuração, o mesmo arquivo .md pode servir tanto como uma nota comum quanto como uma tela de desenho, tudo em um único arquivo. Esta é a parte mais valiosa deste artigo.

Abaixo, dividi em 5 etapas.

5.1 Duas Propriedades Chave

Leitores atentos podem já ter visto essas duas propriedades frontmatter nas minhas capturas de tela de notas anteriores:

excalidraw-plugin: parsed
excalidraw-open-md: true

excalidraw-plugin: parsed: Diz ao plugin Excalidraw que este arquivo .md contém dados do Excalidraw que precisam ser analisados. Sem essa propriedade, o plugin não processará o arquivo.

excalidraw-open-md: true: Abre o arquivo no modo Markdown por padrão (em vez de entrar diretamente no modo de desenho). Definido como true, você verá o texto primeiro ao abrir o arquivo e alternará manualmente quando precisar desenhar. Sem isso, toda vez que você abrir o arquivo, ele vai direto para a tela de desenho, e você teria que voltar para ler o texto — irritante.

Com essas duas propriedades no frontmatter, o arquivo ganha capacidade de “modo duplo”.

5.2 Criando um Arquivo de Modelo

A chave para a configuração dois em um é salvar essa configuração em um arquivo de modelo, para que novas notas a incluam automaticamente, sem adição manual a cada vez.

Passos:

Na sua pasta de modelos (por exemplo, 02 Templates/), crie um novo arquivo .md e nomeie-o “Modelo Excalidraw”.
Copie e cole o seguinte conteúdo nele e salve.

---
excalidraw-plugin: parsed
excalidraw-open-md: true
---

%%
### Drawing
```compressed-json
N4IgLgngDgpiBcIYA8DGBDANgSwCYCd0B3EAGhADcZ8BnbAewDsEAmcm+gV31TkQAswYKDXgB6MSgw4CxAHSp6AWzJJMMJTEZgaCANoBdcuihQAymHRg+oCthhEAQulQBrAOb4ujXAGF6mPT4CCAAxABmkVGqnnhm2ABefIycmJgAvuTh2Oq68MDp6UA
```
%%

Este é um modelo Excalidraw com uma tela vazia. As duas propriedades frontmatter (excalidraw-plugin: parsed e excalidraw-open-md: true) dizem ao plugin que este arquivo está no formato dois em um e deve abrir no modo Markdown por padrão. O compressed-json no final são os dados da tela vazia.

5.3 Configurações do Plugin Excalidraw

Ter um arquivo de modelo sozinho não é suficiente — você também precisa dizer ao plugin Excalidraw “onde encontrar o modelo” e desabilitar uma configuração que interfere no gerenciamento de arquivos.

Caminho: Configurações → Excalidraw

Duas coisas para modificar:

① Definir a localização do modelo: Nas configurações do Excalidraw, encontre a opção “Arquivo de modelo” e insira o caminho para o seu modelo, por exemplo, 02 Templates/Modelo Excalidraw. A partir de então, toda vez que você criar um novo arquivo com Excalidraw, ele usará automaticamente este modelo, incluindo a propriedade excalidraw-open-md: true.

② Desabilitar “Adicionar data ao nome do novo arquivo”: Por padrão, o Excalidraw anexa a data de criação aos nomes dos novos arquivos, por exemplo, Desenho 2026-03-12. Isso torna os nomes dos arquivos verbosos e incompatíveis com a lógica de nomenclatura de modelos do Obsidian. Encontre esta opção e desligue-a.

5.4 Vinculando uma Tecla de Atalho

Alternar entre o modo Markdown e o modo de desenho através do menu de contexto é muito lento — vincule uma tecla de atalho para alternância instantânea.

Caminho: Configurações → Atalhos de teclado → Pesquisar por “Excalidraw”

Encontre esta entrada: “Excalidraw: Alternar entre modo Excalidraw e Markdown”

Vincule-a a Cmd+E (Mac) ou Ctrl+E (Windows). Primeiro verifique se essa combinação de teclas já está em uso — o padrão do Obsidian Cmd+E é para itálico. Se você usa itálico com frequência, escolha uma tecla diferente, como Cmd+Shift+E.

Após vincular, em um arquivo dois em um, pressione Cmd+E para alternar entre “visualizar texto” e “visualizar desenho” — muito conveniente.

5.5 Dados Comprimidos no Final do Arquivo

Após a configuração, toda vez que você salvar o conteúdo do desenho em um arquivo dois em um, um bloco de dados será gerado automaticamente no final do arquivo:

%%
### Drawing
```compressed-json
N4IgLgngDgpiBcIYA8DGBDANgSwCYCd0B3EAGhADcZ8BnbAewDsEAmcm+gV31TkQ...
```
%%

Este bloco de código compressed-json é o resultado da compressão de todos os dados do desenho — coordenadas, cores, conteúdo de texto, relações de conexão — tudo comprimido nesta única linha de string.

Três coisas a observar:

Não exclua este conteúdo manualmente. Se você o excluir, os dados do desenho desaparecem e, ao alternar para o modo Excalidraw, será exibida uma tela vazia.
%% é a sintaxe de comentário do Obsidian. Na visualização de leitura, este conteúdo está oculto e não será exibido, portanto não afeta a legibilidade da nota.
A linha compressed-json deve ser uma única linha completa. Se for quebrada por uma quebra de linha, o arquivo apresentará erro e não abrirá.

Resumo

O que você aprendeu hoje:

Excalidraw = ferramenta de desenho gratuita e de código aberto: Tem uma versão web independente; o Obsidian usa a versão do plugin de terceiros, com estilo de desenho à mão e tela infinita.
Diferença central do Canvas: O Canvas gera arquivos .canvas separados que precisam de gerenciamento independente; os dados do desenho do Excalidraw podem ser comprimidos e incorporados em arquivos .md — um arquivo, dois usos.
Instalação: Configurações → Plugins de terceiros → Plugins da comunidade → Pesquisar e instalar Excalidraw.
Atalhos das ferramentas: Teclas numéricas 1-8 e 0 para alternar ferramentas, Esc para sair da edição, Tab para pular entre elementos, teclas de seta para mover — ritmo central: teclas numéricas para ferramentas + Esc/Tab para navegação.
Desenho com IA: A Skill /obsidian-excalidraw permite que o Claude Code gere desenhos incorporados diretamente, muito mais rápido do que arrastar nós manualmente.
Configuração dois em um: Adicione excalidraw-plugin: parsed + excalidraw-open-md: true ao frontmatter, configure via arquivo de modelo, defina o caminho do modelo nas configurações do Excalidraw, vincule Cmd+E para alternância rápida de modo.
Dados no final do arquivo: O bloco de código ## Drawing + compressed-json são os dados do desenho comprimidos, envoltos em %%, invisíveis na visualização de leitura — não exclua manualmente.

Agradecimentos: A configuração “Dois em Um” deste capítulo referencia o método do criador do Bilibili Fiveth_ (vídeo: BV1hyhPzoEcd, creditado aqui.

Fontes: A Melhoria Oculta para o Conforto de Leitura

Mon, 01 Jan 0001 00:00:00 +0000

Anteriormente, cobrimos os CSS Snippets, ensinando como usar um pequeno trecho de código para ajustar vários detalhes da interface do Obsidian. Este capítulo é a parte final da nossa trilogia de embelezamento — trocar as fontes.

O tópico das fontes é simples e significativo — afinal, é só trocar uma fonte. Mas depois de trocá-la, você provavelmente terá uma reação: “Então eu estava me contentando o tempo todo.” Uma boa fonte não apenas deixa a interface mais bonita; ela faz com que seus olhos se cansem menos toda vez que você abre o Obsidian, a leitura fica mais fluida e faz você querer escrever mais.

Este capítulo aborda quatro coisas:

Fontes têm direitos autorais — como usá-las com segurança
Onde baixar fontes gratuitas
Como instalá-las no Obsidian após o download
Qual fonte eu uso pessoalmente e seu nome confuso

Fontes Têm Direitos Autorais

Primeiro, algo que muitos não sabem: Fontes têm direitos autorais.

Se você pesquisar o nome de uma fonte online, baixá-la, instalá-la e usá-la para si mesmo, ninguém vai te incomodar. Mas se você usar essa fonte em um projeto comercial — como UI de produto, materiais promocionais impressos ou em software lançado — você pode estar infringindo direitos autorais.

Entre as fontes chinesas, há muitas que “parecem gratuitas, mas na verdade têm direitos autorais rigorosos.” Empresas como FounderType e Hanyi têm sistemas de licenciamento específicos: gratuito para uso pessoal, pago para uso comercial. Alguns designers e programadores, sem saber, incluem fontes diretamente em projetos e acabam recebendo cartas legais.

Mas para fazer anotações no Obsidian, que quase nunca é um uso comercial, qualquer fonte é aceitável.

Menciono isso para incutir um hábito: priorize fontes gratuitas e de código aberto. Você pode usá-las sem preocupações legais, mesmo para fins comerciais, e pode modificá-las livremente.

Fontes de código aberto geralmente usam a SIL Open Font License (SIL OFL) — esta licença significa que a fonte é gratuita, pode ser usada para fins pessoais e comerciais, e pode até ser modificada e redistribuída, com o único requisito de que as modificações também sejam de código aberto sob a mesma licença.

Escolher uma fonte com SIL OFL é como escolher “permanentemente gratuito e sem preocupações.”

Onde Baixar Fontes

Depois de discutir direitos autorais, vamos falar sobre fontes de download.

Primeira recomendação: Maoken.com

Site: maoken.com

Este é um site chinês dedicado a catalogar fontes chinesas gratuitas. Ele apresenta centenas de fontes chinesas comerciais gratuitas para uso, cada uma com imagens de pré-visualização e informações de licença. Se você não sabe o que escolher, basta navegar aqui e encontrará facilmente algo de que goste.

Segunda recomendação: GitHub

Muitas fontes de código aberto são lançadas diretamente no GitHub. Por exemplo, a fonte que recomendarei abaixo, LXGW WenKai, está no repositório lxgw/LxgwWenKai no GitHub. Vá para a página de Releases e baixe o arquivo de fonte compactado diretamente.

Acessar o GitHub da China às vezes pode ser lento. Você pode usar um espelho do Gitee ou ir diretamente ao Maoken.com, pois muitas fontes de código aberto também estão coletadas lá.

Notas sobre formatos

Formatos comuns de arquivos de fonte:

.ttf (TrueType Font): Mais universal, suportado tanto no Mac quanto no Windows
.otf (OpenType Font): Formato mais novo, com um pouco mais de recursos, também suportado no Mac/Windows

Qualquer um funciona; você pode usar qualquer um sem preocupações.

Como Instalar Fontes no Obsidian

Após baixar a fonte, há duas etapas: primeiro instalá-la no seu sistema, depois dizer ao Obsidian para usá-la.

Passo 1: Instalar a fonte no sistema

No Mac, clique duas vezes no arquivo .ttf ou .otf baixado. Uma janela de pré-visualização da fonte aparecerá. Clique no botão “Instalar Fonte” no canto superior esquerdo. Pronto.

Alternativamente, você pode arrastar o arquivo de fonte diretamente para o aplicativo Catálogo de Fontes (Font Book) para instalá-lo.

No Windows, clique com o botão direito no arquivo de fonte e selecione “Instalar” ou “Instalar para todos os usuários”. Pronto.

Uma vez instalada, a fonte está na biblioteca de fontes do sistema e pode ser usada por todos os softwares.

Passo 2: Ativar a fonte no Obsidian

O Obsidian tem duas maneiras de trocar fontes: uma é usando as configurações da interface, e a outra é usando um CSS Snippet.

Método 1: Configurações da Interface (Simples, recomendado tentar primeiro)

Caminho: Configurações → Aparência → Fontes

Há três campos de entrada:

Fonte da interface: Fonte usada para elementos da interface como barra lateral, menus, barra de título
Fonte do texto: Fonte usada para o conteúdo das notas (esta é a mais comumente alterada)
Fonte monoespaçada: Fonte monoespaçada usada para blocos de código

No campo “Fonte do texto”, digite diretamente o nome da fonte, por exemplo, LXGW WenKai, pressione Enter, e o Obsidian mudará imediatamente para ela.

O nome da fonte deve ser o nome em inglês, com a capitalização correta. Este é o “nome oficial” após a fonte ser instalada no sistema, não o nome de exibição em chinês.

Como encontrar o nome em inglês de uma fonte? No Mac, abra o Catálogo de Fontes (Font Book), encontre a fonte, e o nome exibido é o nome em inglês. No Windows, verifique em Painel de Controle → Fontes.

Método 2: CSS Snippet (Mais flexível, adequado para controle fino)

No seu arquivo de CSS Snippet, adicione estas linhas:

/* Set fonts */
body {
  --font-text-theme: "LXGW WenKai", "LXGW WenKai CN", serif;     /* Text font */
  --font-interface-theme: "LXGW WenKai", "LXGW WenKai CN", sans-serif; /* Interface font */
}

--font-text-theme controla a fonte do texto, --font-interface-theme controla a fonte da interface. Basta combiná-los em um bloco body {}.

Coloque essas linhas em um arquivo .css, salve-o no diretório .obsidian/snippets/ e ative-o em Configurações → Aparência → CSS snippets.

Ambos os métodos têm efeitos semelhantes. As configurações da interface são mais diretas, enquanto o método CSS é mais flexível e pode ser combinado com outros snippets para gerenciamento. Para uso diário, as configurações da interface são suficientes.

Minha Escolha: LXGW WenKai

Depois de cobrir os métodos, deixe-me compartilhar minha própria escolha: LXGW WenKai.

O nome é um pouco difícil de lembrar em chinês, mas depois de instalá-la, a experiência de leitura em chinês é bastante boa. Ela tem um toque de escrita à mão em estilo regular, não é rígida e é agradável aos olhos mesmo após longas sessões de leitura.

Licença: SIL OFL 1.1, completamente gratuita para uso comercial, sem preocupações com direitos autorais.

Download: GitHub lxgw/LxgwWenKai https://github.com/lxgw/LxgwWenKai/releases

O criador também tem uma conta no Bilibili com o mesmo nome LXGW.

Resumo

O que aprendemos hoje:

Fontes têm direitos autorais; anotações pessoais no Obsidian são ok, mas para projetos comerciais, priorize fontes gratuitas SIL OFL.
Fontes de download recomendadas: Maoken.com (especializado em fontes chinesas gratuitas), GitHub.
Processo de instalação de fontes: clique duas vezes no arquivo .ttf/.otf para instalar no sistema → referenciar no Obsidian.
Trocar fontes no Obsidian: Configurações → Aparência → Fonte do texto, digite diretamente o nome em inglês da fonte.
Método avançado: use a variável --font-text-theme em um CSS Snippet para definir a fonte.
Fonte recomendada: LXGW WenKai, gratuita para uso comercial, ótima experiência de leitura em chinês.

Principais conclusões:

Instale no sistema primeiro, depois digite o nome da fonte. Duas etapas, sem complicação.
Certifique-se de digitar o nome em inglês da fonte corretamente, prestando atenção à capitalização.
Se você não sabe qual fonte escolher, navegue primeiro no Maoken.com.
LXGW WenKai é o que uso atualmente; o nome é difícil de lembrar, mas a fonte é linda.

Hospedagem de Imagens com PicList e Tencent Cloud

Mon, 01 Jan 0001 00:00:00 +0000

Como capítulo final da seção introdutória, vamos configurar a hospedagem de imagens. Tocamos brevemente nisso no Capítulo 02 ao discutir a inserção de imagens — faça upload das imagens para a nuvem, mantenha seu repositório local leve e as imagens acompanharão automaticamente seus artigos quando você publicar. Este capítulo aborda o assunto em profundidade.

Um “serviço de hospedagem de imagens” armazena suas imagens em um servidor na nuvem e usa links externos para referenciá-las, em vez de mantê-las como anexos locais. Isso traz vários benefícios: primeiro, seu repositório local permanece leve e não incha com um monte de imagens; segundo, as imagens têm um link web permanente, facilitando a publicação de seus artigos em blogs, Contas Oficiais do WeChat e outras plataformas, sem precisar reenviar as imagens.

No entanto, há uma ressalva importante: não use hospedagem de imagens para capturas de tela que contenham informações privadas ou chaves de API. As imagens em um serviço de hospedagem são publicamente acessíveis, e vazamentos podem ser problemáticos.

Ferramentas Necessárias

Para configurar a hospedagem de imagens, você precisa de duas coisas:

Upload automático de imagens: Um plugin do Obsidian. Você pode pesquisar e instalá-lo diretamente na loja de plugins da comunidade.
PicList: Software de gerenciamento de hospedagem de imagens. Baixe e instale de https://piclist.cn/.

Depois de instalar ambos, podemos começar a configurar.

Qual Hospedagem de Imagens Escolher?

Existem muitas opções para hospedagem de imagens. Neste tutorial, vou demonstrar a Tencent Cloud porque sua interface é intuitiva e adequada para iniciantes. No entanto, eu pessoalmente uso Cloudflare R2 no dia a dia porque é completamente gratuito e oferece carregamento rápido de imagens em todo o mundo. Se você quiser custo zero total, o GitHub também pode servir como serviço de hospedagem de imagens — basta enviar imagens para um repositório e referenciá-las usando links raw. Todas as três são opções viáveis. Hoje, vamos focar na Tencent Cloud, mas a lógica de configuração é a mesma para as outras — basta alterar o tipo de hospedagem de imagens no PicList.

Passo 1: Configuração do Tencent Cloud COS

Primeiro, vá para https://cloud.tencent.com/ e registre uma conta. Em seguida, clique em “Console” no canto superior direito.

Após entrar no console, pesquise por “Object Storage” no topo ou encontre no menu à esquerda.

Clique em “Create Bucket”.

Comece a configurar. Para Region, selecione a mais próxima de você (por exemplo, estou em Xangai, então escolho “Shanghai”). Para Name, escolha qualquer nome que você goste; eu usei obsidian-test. Para Access Permissions, certifique-se de selecionar “Public Read, Private Write”, caso contrário, outras pessoas não poderão acessar suas imagens. Marque todas as caixas necessárias abaixo e clique em “Next”.

Deixei todas as configurações avançadas como padrão e cliquei em “Next”.

Confirme que a configuração está correta e clique em “Create”.

Após a criação, você verá esta página indicando que o bucket foi criado. Vamos deixá-lo por enquanto.

Em seguida, crie uma chave de API para que o PicList tenha permissão para fazer upload de imagens para o seu bucket. Vá para https://console.cloud.tencent.com/cam/capi e clique em “Create Key”. Um aviso de segurança aparecerá — apenas confirme.

Após a criação, você verá seu SecretId e SecretKey. Salve-os, junto com seu AppID e nome do bucket, localmente imediatamente. Não os compartilhe com ninguém.

Passo 2: Configurar o PicList

Abra o PicList, selecione “Image Hosting” à esquerda e clique em “Add”.

Um formulário de configuração aparecerá. Para “Configuration Name”, você pode inserir qualquer nome que desejar. Preencha os outros campos com as informações que você salvou anteriormente: AppID, SecretId, SecretKey e Bucket Name. Uma coisa importante: a região deve ser inserida no formato pinyin. Por exemplo, para Xangai, use ap-shanghai; para Guangzhou, use ap-guangzhou. Não use caracteres chineses.

Se você encontrar problemas após a configuração, consulte a documentação oficial em https://piclist.cn/configure.html para verificar seus parâmetros.

Após a configuração, é recomendável fazer upload manual de uma imagem de teste no PicList primeiro para confirmar que a hospedagem de imagens funciona corretamente antes de usá-la no Obsidian. A solução de problemas é muito mais complicada se você descobrir problemas apenas no Obsidian.

Passo 3: Configurar o Plugin de Upload Automático de Imagens

Abra as configurações do plugin Image auto upload no Obsidian. Defina o tipo de hospedagem de imagens como “PicGo” e preencha os dois endpoints da API:

Endpoint de upload: http://127.0.0.1:36677/upload
Endpoint de exclusão: http://127.0.0.1:36677/delete

Não tenho certeza se selecionar PicGo preenche automaticamente esses campos, então estou incluindo-os aqui. Você pode consultar minha captura de tela para outras configurações.

Como Usar

Uma vez configurado, basta tirar capturas de tela e inserir imagens locais como de costume enquanto escreve — sem se preocupar com a hospedagem de imagens. Depois de terminar de escrever e revisar seu artigo, use a paleta de comandos para pesquisar por “Upload all images”. Isso fará upload de todas as imagens locais no artigo para o serviço de hospedagem de imagens em um clique. Os links serão substituídos automaticamente e os anexos locais originais serão excluídos.

Uma armadilha comum: se seu artigo contém tanto imagens já enviadas para o serviço de hospedagem quanto imagens locais recém-adicionadas, é recomendável primeiro clicar em “Download all images” para baixar as imagens hospedadas de volta, depois clicar em “Upload all images” para enviar tudo junto. Se você fizer upload diretamente, pode encontrar problemas de desalinhamento de imagens.

Nota para Usuários do WeChat Official Account

Há um ponto importante a esclarecer: Obsidian escreve em Markdown, mas o backend do WeChat Official Account não suporta Markdown. Se você copiar o conteúdo diretamente, a formatação ficará completamente bagunçada e as imagens não serão exibidas — não porque os links de hospedagem de imagens estão bloqueados, mas porque não há renderização alguma.

Existem duas soluções. Uma é usar uma ferramenta de formatação online como doocs-md: cole seu conteúdo do Obsidian nela, e ela renderizará o Markdown em um formato que o backend do WeChat reconhece. Em seguida, copie para o backend do WeChat e as imagens serão exibidas corretamente. A outra é usar meu plugin WeChat Publisher, que funciona diretamente no Obsidian. Ele suporta envio de rascunho com um clique após a renderização, ou você pode copiar manualmente o conteúdo renderizado. Veja o Capítulo 20 deste livro para detalhes. A partir da v0.1.13, é completamente gratuito para usuários individuais.

Resumo

Hospedagem de imagens é um tópico amplo, e há muitas coisas que não cobrimos neste capítulo, como conversão de formato de imagem, regras de nomenclatura automática, vinculação de domínios personalizados e muito mais. No entanto, com a configuração descrita neste capítulo, você deve ser capaz de começar e explorar mais por conta própria.

O que você aprendeu hoje:

A hospedagem de imagens armazena imagens na nuvem, mantendo seu cofre do Obsidian leve e facilitando a publicação em blogs.
Você precisa instalar o plugin Image auto upload e o software PicList. As opções de hospedagem de imagens incluem Tencent Cloud, Cloudflare ou GitHub.
Após a configuração, teste manualmente o upload de uma imagem no PicList primeiro para garantir que tudo funcione antes de usar no Obsidian.
Insira imagens locais como de costume enquanto escreve e, em seguida, faça upload de todas as imagens para o serviço de hospedagem com um clique após terminar; os links são substituídos automaticamente.

Pontos-chave:

Não faça upload de capturas de tela contendo informações privadas ou chaves de API para hospedagem de imagens.
O bucket deve ser definido como “Public Read”, caso contrário, as imagens não podem ser acessadas publicamente.
As chaves de API (SecretId/SecretKey) devem ser salvas localmente e não compartilhadas.
A região deve ser inserida no formato pinyin, por exemplo, ap-shanghai.
Se seu artigo contiver imagens hospedadas e locais, baixe todas primeiro e depois faça upload juntas.
Usuários do WeChat Official Account: o WeChat bloqueia links de imagens externas. Use doocs-md para converter ou meu plugin para processamento com um clique.

Local Backup: O Melhor Plugin de Backup para Iniciantes

Mon, 01 Jan 0001 00:00:00 +0000

Amigos, hoje vamos falar sobre fazer backup do Obsidian.

A importância dos backups é indiscutível — eles evitam exclusões acidentais e deslizes, especialmente agora que muitas operações são orientadas por IA. Se algo der errado, pode desencadear uma reação em cadeia. Os backups podem ajudá-lo a se recuperar parcialmente ou até completamente.

Opções de Backup

Existem duas abordagens principais: backup local e backup na nuvem.

Backup local significa exatamente o que parece: você cria uma ou mais cópias em outra pasta no seu computador local, que pode restaurar sempre que necessário. Métodos comuns incluem copiar arquivos manualmente, usar plugins ou ferramentas como o Kopia.
Backup na nuvem armazena seus backups na nuvem, incluindo, mas não se limitando a, seu NAS, VPS, GitHub ou serviços como Cloudflare.

Quanto a mim, escolho ambos. Meus documentos são copiados localmente e para a nuvem todas as manhãs às 9h — proteção dupla!

Mas hoje, vamos começar com o método mais amigável para iniciantes: usar o plugin Local Backup para backups locais.

Como Usar o Plugin

Como mencionado anteriormente, abra o mercado oficial de plugins, procure pelo plugin e instale-o.

Em seguida, abra as configurações do plugin. Observe que um ícone correspondente também aparece na barra lateral esquerda para acesso rápido.

Ver um monte de inglês pode ser intimidante? Não se preocupe — traduzi tudo para você. Bem atencioso, né? 😊

As configurações são diretas. Basta escolher o que você precisa. Se não tiver certeza, pode consultar minha configuração: backup a cada saída do Obsidian, manter backups dos últimos 7 dias (excluir automaticamente os antigos) e salvar no máximo 2 backups por dia.

Além disso, lembre-se de definir o caminho do backup de acordo com seu sistema; caso contrário, ele usará o diretório do seu vault como padrão.

Depois de configurado, clique no ícone à esquerda para testar se funciona. Você pode ver que um backup foi criado com sucesso.

Se você vir uma notificação verde ou um novo arquivo de backup na pasta de destino, a configuração foi bem-sucedida.

Problemas Comuns

Além disso, note que encontrei um erro antes porque minha pasta do vault continha um ambiente virtual.

A solução é simples: adicione padrões de exclusão na opção mostrada na captura de tela. Se não tiver certeza, pode copiar minha lista:

.venv, __pycache__, node_modules, .git, .trash

Dica: Converter PDFs para Markdown para Reduzir o Tamanho do Backup

Se o seu pacote de backup continua crescendo, primeiro verifique se você adicionou muitos PDFs ao seu vault.

Arquivos PDF são grandes, então ter muitos deles vai inflar seus backups. Converter PDFs de referência para Markdown preserva o conteúdo enquanto reduz significativamente o tamanho do backup. Por exemplo, um PDF de 504KB se torna apenas 13KB após a conversão (a proporção varia por arquivo).

E não se preocupe com imagens — a ferramenta de conversão as insere automaticamente como links de hospedagem de imagens.

Atualmente, existem ferramentas online gratuitas disponíveis:

O uso é simples: basta arrastar e soltar o PDF para convertê-lo.

Após a conversão, o lado esquerdo mostra o original e o lado direito mostra o formato convertido. Clique no botão de download à direita para salvá-lo localmente.

Você pode ver que o PDF original tem 504KB, enquanto a versão convertida tem apenas 13KB.

A imagem abaixo compara as versões PDF e Markdown — elas parecem muito semelhantes.

Observe que essas imagens estão hospedadas no próprio serviço de hospedagem de imagens do site, e é incerto por quanto tempo serão preservadas. Recomenda-se migrá-las para sua própria hospedagem de imagens, conforme descrito no capítulo sobre hospedagem de imagens, para que, mesmo que o site remova a hospedagem, seu uso não seja afetado.

Ao fazer anotações, você pode usar a visualização em tela dividida: abra o mesmo documento em ambos os lados, visualizando o Markdown convertido de um lado enquanto escreve anotações do outro. Uma configuração com dois monitores torna isso ainda mais conveniente.

Resumo

O que aprendemos hoje:

Local Backup é o plugin de backup local mais simples para o Obsidian — basta instalá-lo, definir o caminho e funciona sem nenhuma linha de comando.
Apenas três passos para configurar: Instalar o plugin → Definir o caminho e as regras de backup → Clicar no ícone esquerdo para verificar.
Teste antes de confiar — clique em “Try” para confirmar que o caminho é gravável. Não espere até perder dados para verificar.
Correção de erro comum: Verifique a lista de exclusão e adicione diretórios temporários como .venv, node_modules, .git, etc.

Principais conclusões:

Backup local + backup na nuvem para proteção dupla — esta é a abordagem mais confiável.
Iniciantes podem começar apenas com backup local — não há necessidade de mergulhar em NAS ou sincronização com GitHub imediatamente.
Verifique uma vez antes de confiar nos backups para garantir que o caminho e as exclusões estejam corretos.

Parte 2 · Fluxo de Trabalho: Faça Você Abri-lo Todos os Dias

Modelos do Obsidian: Escreva Mais Rápido com Formatos Reutilizáveis

Mon, 01 Jan 0001 00:00:00 +0000

Já cobrimos as propriedades das notas — adicionar título, data, categorias a cada nota. Mas você logo perceberá um problema: toda vez que cria uma nova nota, precisa preencher manualmente essas propriedades e configurar o formato novamente. Os modelos foram criados para resolver esse trabalho repetitivo.

Por que você precisa de Modelos?

Você pode pensar: preencher manualmente algumas linhas de propriedades não é grande coisa. Mas vamos fazer as contas. Cada post de blog precisa de título, data, categorias. Cada nota de livro também precisa de autor, editora, minha avaliação. Uma ou duas notas, você nem sente. Mas quando você tem dezenas ou centenas de notas, ter que digitar esses campos fixos do zero toda vez se torna irritante. Mais importante ainda, a digitação manual está sujeita a erros — formato de data errado, nomes de categorias inconsistentes, levando a resultados de pesquisa incompatíveis mais tarde.

Os modelos resolvem esse problema: Escreva o formato da sua nota antecipadamente, salve-o e aplique-o com um clique quando necessário — sem necessidade de digitação manual.

Passo 1: Ative o plugin principal Modelos

Modelos é um plugin principal no Obsidian. Ele não está ativado por padrão, então você precisa ativá-lo manualmente. Vá em Configurações → Plugins principais → encontre “Modelos” → ative a chave à direita.

Após ativá-lo, um pequeno ícone de engrenagem aparecerá à direita da linha “Modelos” na lista de Plugins principais. Clique nele para configurar.

Passo 2: Defina a localização da pasta de modelos

Abra as configurações do plugin Modelos. A configuração mais importante é a Localização da pasta de modelos. Digite o nome da pasta onde você armazena seus arquivos de modelo. Por exemplo, no meu cofre, uso uma pasta chamada 02-Templates, então digito isso. Todos os arquivos nesta pasta serão reconhecidos como modelos. Quando você invocar um modelo, o Obsidian listará todos os arquivos desta pasta para você escolher.

Se você ainda não tem essa pasta, crie uma primeiro, depois volte para preencher o caminho.

Passo 3: Crie seu primeiro modelo

Crie um arquivo de modelo

Na sua pasta de modelos designada (ex.: 02-Templates), crie um novo arquivo — use o atalho Cmd+N, ou clique com o botão direito na pasta e selecione “Novo arquivo”. Este arquivo é exatamente como uma nota normal; basta escrever o conteúdo como de costume. Uma vez salvo, ele se torna seu modelo.

Variáveis de modelo

A parte mais crucial dos modelos são as variáveis. Como mencionado anteriormente, escrever {{date}} nas propriedades preenche automaticamente a data. Vamos detalhar as três variáveis internas:

Variável	Descrição	Exemplo
`{{date}}`	Data em que o modelo é inserido	2026-03-04
`{{time}}`	Hora em que o modelo é inserido	14:30
`{{title}}`	Nome do arquivo da nota atual	Minha Nota de Livro

Foco em {{date}}.

Esta variável é dinâmica — toda vez que você usa o modelo, ela é substituída pela data atual. Compare as duas abordagens:

Escrever date: 2026-03-04 (fixo) → todas as notas criadas com este modelo terão a data 2026-03-04, para sempre.
Escrever date: {{date}} → use hoje, ele preenche hoje; use amanhã, ele preenche amanhã.

Portanto, sempre use {{date}} para a propriedade de data em vez de fixá-la. Este é o truque que mencionei anteriormente.

Passo 4: Usando modelos

Inserir um modelo após criar uma nota

Primeiro crie uma nova nota, depois insira o modelo.

Após criar uma nota em branco, há duas maneiras de inserir um modelo:

Método 1: Paleta de Comandos (Recomendado)

Pressione Cmd+P para abrir a Paleta de Comandos, digite “Inserir modelo”, pressione Enter e selecione o modelo desejado na lista.

Método 2: Botão na barra lateral

Se você ativou o botão de modelo nas configurações, um ícone de modelo aparecerá na barra de ferramentas esquerda. Clique nele para selecionar um modelo diretamente.

Ambos os métodos funcionam; use o que achar mais confortável. A vantagem da Paleta de Comandos é que você não precisa lembrar onde está o botão — basta pressionar Cmd+P e pesquisar.

Exemplos práticos de modelos

Agora que cobrimos a teoria, vamos ver alguns modelos reais.

Modelo de Post de Blog (consistente com o formato deste livro):

---
title: {{title}}
date: {{date}}
categories:
  -
---

Modelo de Nota de Livro:

---
title: {{title}}
date: {{date}}
categories:
  - Reading Notes
---
Publisher:
Date finished: {{date}}

# Core Ideas

# Memorable Passages

# My Review

Modelo de Diário:

---
date: {{date}}
---

## What I Did Today

## Problems I Ran Into

## Plan for Tomorrow

Esses três modelos cobrem os cenários mais comuns. Você pode usá-los diretamente ou modificá-los ao seu gosto. Comece com alguns modelos de uso comum e adicione novos modelos quando encontrar formatos repetitivos. Não tente pensar em todos os casos possíveis desde o início — pensar demais muitas vezes leva a não usá-los.

Resumo

O que você aprendeu hoje:

Ative o plugin principal “Modelos” (Configurações → Plugins principais → ativar)
Defina a pasta de modelos (todos os arquivos nesta pasta são reconhecidos como modelos)
Três variáveis internas: {{date}} / {{time}} / {{title}}
Inserir um modelo: Cmd+P, pesquise “Inserir modelo”, selecione o modelo desejado

Principais conclusões:

Use {{date}} para a propriedade de data em vez de fixá-la — ela preenche automaticamente a data atual cada vez que você usa o modelo.
Modelos são apenas notas normais — coloque-os na pasta designada, sem configuração especial necessária.
Comece com alguns modelos de uso comum, apenas o suficiente para suas necessidades — não projete demais.

Notas Diárias: O Primeiro Hábito para Iniciantes no Obsidian

Mon, 01 Jan 0001 00:00:00 +0000

Já falamos sobre atalhos de teclado — vincular comandos usados com frequência a teclas para dobrar sua velocidade. Agora vamos falar sobre outro plugin principal: Notas Diárias.

O recurso de Notas Diárias merece um capítulo à parte, não por ser complicado, mas porque muitos usuários do Obsidian nunca o usam após a instalação, perdendo um hábito valioso.

Por que escrever Notas Diárias

Vamos começar com um problema real: muitas pessoas não escrevem notas diárias não porque não querem, mas porque parece trabalhoso — digitar, organizar, pensar no que escrever.

Então vamos começar com um método: entrada por voz.

Doubao, Xunfei Input ou o teclado de voz integrado do seu sistema funcionam. Abra sua nota diária, mude para entrada por voz, fale por alguns minutos sobre o que aconteceu hoje, pare, e o texto é transcrito automaticamente. Sem digitar, sem se preocupar com estrutura — apenas fale.

Isso reduz a barreira para escrever notas diárias ao mínimo. Depois de falar um parágrafo, ocasionalmente adicione uma quebra de linha manualmente, e pronto em dois ou três minutos.

Não se preocupe com a qualidade. Um registro simples está perfeitamente bem. Onde você foi, o que aconteceu, o que pensou — apenas anote.

O importante não é o quão bem você escreve, mas que você registre seus pensamentos, emoções e eventos atuais.

O que você pode fazer com suas notas diárias?

Além de revisá-las você mesmo, há um método cada vez mais útil: enviar suas notas diárias para uma IA e pedir que ela as revise e resuma para você.

Por exemplo, cole a última semana ou mês de notas diárias e pergunte à IA: “Com o que tenho me ocupado principalmente? Existem padrões? Alguma mudança de humor perceptível?”

A IA pode ajudar a identificar padrões que você talvez não perceba — em quais dias você estava em um estado ruim, quando foi mais produtivo, como sua mentalidade mudou em torno de uma decisão. Isso é muito mais eficiente do que folhear as entradas uma por uma.

Uma única nota diária não vale muito, mas cem notas são dados.

Passo 1: Ativar o Plugin Principal de Notas Diárias

Notas Diárias é um plugin principal no Obsidian, desabilitado por padrão. Você precisa ativá-lo manualmente.

Caminho: Configurações → Plugins Principais → Encontre “Notas Diárias” → Ative o interruptor à direita.

Após ativar, um ícone de calendário aparecerá na barra lateral esquerda. Clique nele para abrir diretamente a nota diária de hoje.

Passo 2: Configurar as Notas Diárias

Depois de ativar, um pequeno ícone de engrenagem aparecerá à direita da linha “Notas Diárias” em Plugins Principais. Clique nele para configurar.

Algumas opções a observar:

Formato da Data

O padrão é YYYY-MM-DD, como 2026-03-09. Geralmente você não precisa alterar — esse formato é fácil de ordenar e pesquisar.

Se você tiver uma preferência (por exemplo, incluindo o dia da semana YYYY-MM-DD dddd), pode personalizar aqui. As regras de formato são as mesmas de {{date:YYYY-MM-DD}} em modelos.

Local do Novo Arquivo

Os arquivos de notas diárias são criados na raiz do cofre por padrão. Recomenda-se alterar para uma pasta dedicada, como 07 Notas Diárias ou 07 Revisão/Diário. Isso mantém suas notas diárias separadas de outras notas para facilitar o gerenciamento.

Arquivo de Modelo

Insira o caminho para o seu modelo de nota diária aqui. Uma vez definido, cada vez que você criar a nota diária de hoje, ele aplicará automaticamente esse modelo — sem necessidade de invocá-lo manualmente.

Esse recurso funciona com o próximo passo: primeiro crie o modelo, depois volte e preencha o caminho.

Passo 3: Criar um Modelo de Nota Diária

Na sua pasta de modelos (por exemplo, 02 Modelos), crie um novo arquivo e nomeie-o como “Modelo de Nota Diária” ou “Registro Diário” — o que preferir.

Escreva uma estrutura para o que você deseja registrar a cada dia. Uma versão básica prática:

---
date: {{date}}
---

## What I did today

## Problems encountered

## Plans for tomorrow

Este é o mesmo exemplo de modelo de nota diária do capítulo sobre modelos. Se você já o criou naquela época, use-o diretamente — não precisa recriar.

Algumas observações:

{{date}} será automaticamente substituído pela data atual, sem necessidade de preenchê-lo manualmente.
As três seções são uma estrutura mínima. Adicione ou remova com base nos seus hábitos.
Se você usa entrada por voz, pode tornar a estrutura ainda mais simples — por exemplo, mantenha apenas uma seção “## Hoje” sem subseções e escreva um registro de fluxo de consciência.
Não torne muito complexo. A razão principal pela qual você consegue manter as notas diárias é uma coisa: baixa barreira.

Após criar o arquivo de modelo, volte às configurações de Notas Diárias do passo anterior e preencha o caminho do arquivo de modelo (apenas o nome do arquivo, por exemplo, 02 Modelos/Modelo de Nota Diária).

Passo 4: Começar a Escrever Notas Diárias

Uma vez configurado, há três maneiras de abrir a nota diária de hoje:

Método 1: Ícone da Barra de Ferramentas

Clique no ícone de calendário na barra lateral esquerda para abrir diretamente a nota diária de hoje. Se ela ainda não existir, será criada automaticamente.

Método 2: Paleta de Comandos

Pressione Cmd+P para abrir a paleta de comandos, digite “Abrir nota diária de hoje” e pressione Enter.

Método 3: Atalho de Teclado

Se você acha que abrirá sua nota diária todos os dias, vale a pena atribuir um atalho de teclado (conforme descrito na seção de atalhos). Uma vez definido, um único toque de tecla leva você até lá.

Escolha o método que achar confortável. Eu uso o ícone da barra de ferramentas — um clique é suficiente.

Resumo

O que você aprendeu hoje:

Ativar o plugin Notas Diárias: Configurações → Plugins Principais → Notas Diárias → Ativar
Configurar três itens: Formato da data, pasta de armazenamento, caminho do arquivo de modelo
Criar um modelo de nota diária: Coloque-o na sua pasta de modelos, {{date}} preenche automaticamente a data
Métodos de abertura: Ícone da barra de ferramentas / Cmd+P pesquisar “Abrir nota diária de hoje” / Atalho de teclado personalizado

Pontos-chave:

Entrada por voz é a maneira mais fácil de escrever — use Doubao ou outros métodos de entrada, fale por alguns minutos, o texto é transcrito automaticamente, sem necessidade de digitar.
Não torne o modelo muito complexo — quanto menos seções, mais fácil manter o hábito. Apenas comece.
Depois de acumular notas diárias, você pode enviá-las para uma IA para resumir padrões e revisar o progresso, o que é muito mais eficiente do que folheá-las você mesmo.

O Método Karpathy: Construa uma Wiki Pessoal com LLMs

Mon, 01 Jan 0001 00:00:00 +0000

Recentemente, um Gist de Andrej Karpathy se espalhou pela comunidade tech. Depois de lê-lo, meu primeiro pensamento foi: essa ideia tem uma conexão mais profunda com o Obsidian do que a maioria das pessoas imagina. Este artigo é sobre isso.

Quem é Karpathy

Se você acompanha o mundo da IA, esse nome deve ser familiar. Mas se você não sabe muito sobre ele, acho que vale a pena explicar primeiro.

Karpathy não é aquele tipo de “líder de IA que gerencia produtos em uma grande empresa”; ele é verdadeiramente um dos próprios do campo do deep learning.

Ele fez seu doutorado em Stanford sob orientação de Fei-Fei Li — a pessoa que liderou o ImageNet e essencialmente lançou a visão computacional moderna. Depois de sair do grupo de Fei-Fei Li, Karpathy foi para a OpenAI como um dos cofundadores. Em 2017, a Tesla o contratou para liderar o sistema de percepção visual do Autopilot.

Durante seus anos na Tesla, muitas pessoas agora conhecem o resultado: a Tesla foi quase a única empresa de direção autônoma na época que insistiu em uma abordagem puramente visual — sem lidar, apenas câmeras + redes neurais. Essa abordagem foi fortemente criticada na época como radical demais. Os resultados depois ficaram claros para todos.

Ele saiu da Tesla em 2022, voltou brevemente para a OpenAI em 2023, depois saiu novamente para iniciar seu próprio projeto de educação em IA, karpathy.ai.

O que acho interessante nele não é apenas seu currículo, mas que ele mantém um estado raro: capaz de fazer engenharia de nível mundial, mas disposto a passar tempo escrevendo artigos e gravando cursos para explicar a lógica subjacente da tecnologia para pessoas comuns.

Seus nanoGPT e micrograd no GitHub são reimplementações mínimas de GPT e retropropagação, projetadas especificamente para que pessoas comuns realmente entendam. Seu curso CS231n no YouTube ensinou deep learning a inúmeras pessoas.

Então, quando ele escreveu um Gist no GitHub sobre “usar LLMs para gerenciar bases de conhecimento”, ele rapidamente se espalhou pela comunidade tech. Acho que vale uma leitura cuidadosa.

O que Ele Disse

O Gist se chama LLM Wiki: A pattern for building personal knowledge bases with LLMs. O link original:

https://gist.github.com/karpathy/442a6bf555914893e9891c11519de94f

Seu ponto de partida é um sentimento que muitos já tiveram: Sua base de conhecimento continua crescendo, mas o que você realmente consegue usar continua diminuindo.

Você marca artigos como favoritos, faz anotações de leitura no Notion, constrói uma pilha de notas no Obsidian, mas na próxima vez que precisar de um certo conhecimento, a probabilidade de encontrá-lo não é alta. Não é que você não consiga encontrar — é muito disperso, sem conexões entre eles. Mesmo se encontrar, são fragmentos que você precisa juntar sozinho.

Ele atribui esse problema às deficiências de duas soluções existentes:

Primeiro: A abordagem de favoritos.
Você joga o texto original lá, não faz nada, e depende inteiramente da busca. O problema é que a busca encontra documentos, não respostas. Você ainda precisa ler, entender e sintetizar por conta própria.

Segundo: A abordagem RAG (Retrieval-Augmented Generation).
Você fornece um monte de documentos para a IA, que recupera e gera respostas na hora. Isso é muito melhor que favoritos, mas é sempre temporário, começando do zero a cada vez, sem acúmulo.

O LLM Wiki que ele propõe é uma ideia diferente: Não deixe a IA organizar temporariamente durante a busca; em vez disso, deixe a IA manter continuamente uma Wiki que está sempre sendo atualizada.

Como o LLM Wiki Funciona

Toda a arquitetura tem três camadas:

Fontes Brutas
São as coisas que você normalmente lê: artigos, livros, legendas de vídeos, anotações de reuniões. Elas são armazenadas aqui como estão, como material bruto.

A Wiki
Um conjunto de arquivos Markdown, cada um correspondendo a um tópico, conceito ou entidade. Por exemplo, você pode ter uma página “Machine Learning - Overfitting”, uma página “Anotações de Leitura - Estar no Jogo” e uma página “Pessoas - Feynman”.

Esses arquivos não são escritos por você; eles são escritos e mantidos continuamente pela IA. Cada vez que um novo material chega, a IA atualiza as páginas relevantes; referências cruzadas são estabelecidas entre páginas; se surgirem contradições, elas são sinalizadas.

O Schema
Uma configuração que diz à IA “como essa Wiki deve ser”. Por exemplo, quais campos cada nota deve conter, como organizar, o que constitui uma nota órfã, quais conceitos precisam de sua própria página.

Depois, três operações principais:

Ingest
Cada vez que um novo material chega, a IA o lê e atualiza de 10 a 15 páginas da Wiki. Não apenas criando novas, mas também atualizando conteúdo existente, adicionando referências cruzadas e sinalizando áreas que precisam de mais confirmação.

Query
Você faz uma pergunta, e a IA sintetiza uma resposta a partir da Wiki. O ponto chave é: se a própria consulta produz novas integrações valiosas, a IA também as escreve de volta na Wiki. Em outras palavras, quanto mais você usa, mais rica a Wiki se torna.

Lint
Esta é uma operação que ele menciona especificamente, e acho que é a parte mais inteligente do esquema. A IA periodicamente realiza uma verificação de saúde em toda a Wiki:

Existem duas páginas com conteúdo contraditório?
Existem afirmações desatualizadas?
Existem páginas órfãs sem links de outras páginas?
Existem referências cruzadas obviamente ausentes?

Fazer essas coisas manualmente seria tedioso e quase impossível de sustentar. Mas para a IA, é puro trabalho braçal.

A divisão de trabalho é a seguinte:

Humanos são responsáveis por: curadoria (escolher o que vale a pena incluir), julgamento crítico (essa conclusão está correta?), supervisão (revisar periodicamente as atualizações da IA)
IA é responsável por: bookkeeping — referências cruzadas, manutenção de consistência, limpeza de nós órfãos, formatação

Ele usa o termo: bookkeeping. Essa palavra é bem escolhida. Não se trata de deixar a IA pensar por você, mas de entregar as tarefas de manutenção que você sabe que deveria fazer, mas continua adiando, para a IA.

Por Que Usuários do Obsidian Devem Prestar Atenção Especial

Notei algo recentemente: alguns amigos da comunidade de programação, que antes não se interessavam pelo Obsidian, começaram a usá-lo um após o outro.

Quando perguntados por quê, as respostas são quase as mesmas: porque é muito adequado para trabalhar com IA. Arquivos locais, Markdown puro, sem dependência — essas costumavam ser preferências de nicho, mas agora se tornaram vantagens. Ferramentas como Claude Code podem ler e escrever diretamente em um Vault do Obsidian sem nenhuma configuração extra; o que a IA pode fazer, ela faz diretamente.

O Gist do Karpathy, de certa forma, torna isso ainda mais claro.

Eu mesmo uso o Obsidian há um tempo, e depois de ler esse Gist, tive uma forte sensação:

A Wiki que ele descreve é essencialmente um Vault do Obsidian mantido ativamente por uma IA.

Pense bem: qual é o núcleo do Obsidian? Um monte de arquivos Markdown locais, conectados por links bidirecionais.

Qual é o núcleo do LLM Wiki? Um monte de arquivos Markdown, mais uma IA que ajuda você a criar e manter links, integrar conteúdo e realizar verificações de saúde.

O meio subjacente é exatamente o mesmo. Um Vault do Obsidian é quase a implementação mais natural de um LLM Wiki.

As coisas que você faz manualmente agora — criar links bidirecionais para notas, escrever Mapas de Conteúdo (MOCs), organizar e arquivar periodicamente — uma parte significativa disso pode ser feita pela IA como “trabalho de bookkeeping” no design do LLM Wiki.

Deixe-me dar um exemplo meu: depois que termino de escrever um artigo, a etapa de criar e organizar links bidirecionais agora é tratada por uma Skill. A IA escaneia meu vault de notas, encontra artigos relacionados e adiciona automaticamente links bidirecionais. Eu costumava procrastinar nessa etapa toda vez, mas agora quase não me preocupo com isso.

O LLM Wiki do Karpathy leva isso adiante: não apenas executar uma vez após escrever um artigo, mas manter toda a base de conhecimento em um estado continuamente mantido, com Ingest, Query e Lint automatizados.

Claro, também há vozes que acham que essa abordagem tem problemas.

Alguns na comunidade tech fizeram uma comparação com o Zettelkasten: o Zettelkasten tradicional enfatiza que o ato de escrever notas ativamente é em si o processo de entendimento — não coletar, mas construir conexões através da escrita. Se a IA resume e cria associações para você, esse processo de entendimento não desaparece? Você obtém uma base de conhecimento arrumada, mas não há nada no seu cérebro?

Essa é uma questão real, e acho que não há uma resposta padrão.

Mas para usuários do Obsidian, meu próprio julgamento é: essas duas coisas não são contraditórias, desde que você esclareça quais tarefas são “realmente precisam de pensamento” e quais são “bookkeeping chato”.

Por exemplo:

Ler um artigo, extrair ideias centrais, escrever seus próprios sentimentos e reflexões → isso é pensamento, deve ser feito por você
Verificar quais notas não foram linkadas nos últimos três meses → isso é bookkeeping, perfeitamente razoável delegar à IA
Sintetizar múltiplas fontes sob um conceito → pode ter um rascunho da IA, você revisa
Manter campos de frontmatter de um monte de notas → isso é puro trabalho braçal, a IA faz

O risco real não é que você pare de pensar por usar IA, mas que você equipare “ter a IA resumindo este artigo” com “eu li este artigo.”

Desde que você consiga distinguir isso, a abordagem LLM Wiki é, na verdade, uma extensão bastante valiosa para usuários do Obsidian.

Próximos Passos

O Gist do Karpathy está atualmente no estágio de “propor um bom padrão, mas não fornecer uma ferramenta pronta para uso.”

Algumas pessoas na comunidade começaram a implementar essa ideia em diferentes direções, mas ainda é muito cedo.

Eu pretendo atualizar seriamente minha própria configuração: primeiro reorganizar meu vault de notas do Obsidian de acordo com a abordagem LLM Wiki, depois levar minha Skill existente de links bidirecionais adiante, tentando adicionar lógica de Ingest e Lint para torná-la uma Skill mais completa.

Usando Claude Code + Obsidian Vault, vou executar todo o processo do início ao fim — ver o que funciona, quais são as armadilhas e o que precisa ser reprojetado. Se funcionar, vou empacotar tudo e compartilhar, para que outros possam usar diretamente sem construir do zero.

O próximo capítulo cobrirá esse processo prático.

Resumo

O que aprendemos hoje:

Karpathy é um pesquisador de deep learning de Stanford, líder da abordagem puramente visual do Autopilot da Tesla e cofundador da OpenAI, atualmente focado em educação em IA.
LLM Wiki é um padrão onde “a IA mantém ativamente a base de conhecimento”, em oposição à recuperação passiva no RAG.
A arquitetura central tem três camadas: Fontes Brutas → Wiki (coleção de arquivos Markdown) → Schema (definição de estrutura).
Três operações: Ingest (ingerir e atualizar) / Query (consultar e escrever de volta) / Lint (verificação de saúde).
A divisão central do trabalho: humanos fazem curadoria e julgamento, IA faz “bookkeeping” — referências cruzadas, manutenção de consistência, limpeza de nós órfãos.

Principais conclusões:

Um Vault do Obsidian é em si uma coleção de arquivos Markdown, altamente consistente com o meio do LLM Wiki, tornando-o quase a implementação mais natural.
Os links bidirecionais e MOCs que você cria manualmente agora são exatamente as referências cruzadas mantidas automaticamente pela IA no LLM Wiki.
Preocupar-se com “a IA pensando por você” é razoável, mas isso é diferente de ter a IA fazendo “bookkeeping” — não confunda os dois.
Este padrão atualmente não tem uma ferramenta pronta para uso; você precisa construir a sua própria.
O próximo capítulo abordará uma implementação prática; se funcionar, será empacotado como uma Skill e compartilhado.

Obsidian Base: Crie Sua Própria Galeria e Tabela de Dados

Mon, 01 Jan 0001 00:00:00 +0000

Muita gente já comparou Obsidian e Notion, e a maior frustração sempre foi esta: Obsidian é gratuito, mas sempre deixou a desejar em tabelas, cartões e bancos de dados.

Antigamente, para montar um banco de dados decente no Obsidian, você precisava apelar para plugins ou juntar manualmente propriedades e Dataview. Dava para fazer, mas a barreira era alta. Agora, o recurso oficial Base preencheu essa lacuna em grande parte.

Ele não transformou o Obsidian em outro Notion, mas é o suficiente para você criar tabelas, listas, bibliotecas de cartões, galerias de filmes, acervos de mídia e muito mais dentro do seu próprio cofre.

Este artigo vai explicar o que é a Base, como criar uma e as duas direções mais práticas e amigáveis para iniciantes: fazer tabelas e fazer uma galeria de filmes.

O que é a Base?

Primeiro, o ponto mais importante: a Base não transforma suas notas em um sistema novo e misterioso; ela adiciona uma camada de visualização de banco de dados aos seus arquivos Markdown existentes.

O formato de arquivo é .base, que você pode pensar como um “arquivo de configuração do banco de dados”. Esse arquivo define:

Quais notas exibir
Qual visualização usar
Como filtrar
Como ordenar
Quais propriedades mostrar

Ou seja, seus dados continuam sendo aqueles arquivos Markdown; a Base apenas os organiza de uma forma mais intuitiva.

É aqui que ela difere muito do Notion.

O banco de dados do Notion é essencialmente o próprio banco; já a Base do Obsidian é essencialmente orientada a arquivos. Uma linha, um cartão, uma entrada que você vê geralmente corresponde a um arquivo real.

Isso tem prós e contras:

O benefício é que seu conteúdo continua local, nas suas próprias pastas, sem ficar preso a uma plataforma.

O custo é que ela é mais adequada para bancos de dados, listas, listas de leitura, acervos de mídia, listas de projetos; mas se você quiser usar para um sistema que “registra cada segundo com estrutura complexa”, vai precisar adaptar um pouco a abordagem.

Como criar uma Base?

Criar uma é bem simples. Clique com o botão direito em uma pasta no explorador de arquivos à esquerda e você verá uma nova opção: Novo banco de dados.

Depois de clicar, o Obsidian gera um arquivo .base. Esse arquivo não são os seus dados em si, mas o “manual de instruções” para essa visualização de banco de dados.

Essa etapa é importante porque muitos usuários de primeira viagem acham que estão “criando uma tabela”. Na verdade, não. Você está criando uma nova forma de visualizar arquivos.

Por exemplo, se você criar uma Base em uma pasta, ela geralmente vai puxar muitas notas do escopo. Não entre em pânico. O próximo passo não é inserir dados, mas aprender a controlá-la.

Depois que você entender esses botões no canto superior direito, já dominou a Base:

Ordenar: decide o que ver primeiro
Filtrar: decide o que entra nessa visualização. Por exemplo, de qual pasta os arquivos desse banco de dados vêm é definido aqui; caso contrário, por padrão, todas as notas podem entrar.
Propriedades: decide o que essa coluna mostra
Pesquisar: pesquisa dentro dos resultados atuais da Base
Novo: adiciona uma nova entrada diretamente a essa Base

Como eu uso a Base?

Para demonstração, criei um arquivo Demo-Base.base com três visualizações mais comuns:

Tabela
Cartão
Lista

Essa abordagem é ótima para o dia a dia. Porque na maioria das vezes não precisamos de um “banco de dados supercomplexo”; precisamos de: o mesmo conjunto de conteúdo, visto de formas diferentes para cenários diferentes.

Por exemplo, ao organizar materiais de artigos, a tabela é boa para visualizar propriedades em lote; ao fazer um acervo de mídia, os cartões são mais intuitivos; quando você só quer passar os olhos rapidamente pelos títulos, a lista é mais rápida.

Primeiro, o mais prático: Visualização em Tabela

A visualização em tabela é a mais fácil de entender; ela basicamente organiza um monte de notas em linhas e colunas.

É muito parecida com o Excel, e também com a clássica visualização de banco de dados em tabela do Notion.

Esse modo é especialmente bom para:

Visualizar títulos, datas, tags, categorias de arquivos
Verificar em lote se as propriedades estão preenchidas corretamente
Ordenar rapidamente, por exemplo, por data, avaliação, prioridade
Fazer gerenciamento leve de dados, como listas de livros, listas de projetos, registros de despesas

Se você é novo na Base, sugiro não pensar ainda em fórmulas, links, estruturas complexas. Primeiro, familiarize-se com as três funções: filtrar, ordenar e exibição de propriedades.

Porque o mais valioso da Base agora não é mostrar habilidades, mas finalmente permitir que você gerencie conteúdo de uma forma mais amigável no Obsidian.

Visualização em Lista: A mais simples, mas também a mais rápida

Muita gente ignora a visualização em lista porque ela não parece tão profissional quanto a tabela nem tão bonita quanto os cartões. Mas ela tem uma grande vantagem: leveza.

Quando você só quer navegar rapidamente por um lote de títulos de arquivos, ou examinar o conteúdo com base nos resultados de um filtro, a visualização em lista é na verdade a mais conveniente.

Ela é especialmente boa para:

Ver o que você escreveu recentemente
Ver quais artigos estão sob uma determinada tag
Verificar rapidamente se uma pasta tem conteúdo indesejado
Usá-la como uma “página de resultados de pesquisa”

Às vezes, quanto mais simples a ferramenta, mais frequentemente é usada. A visualização em lista é esse tipo de coisa.

Visualização em Cartão: É aqui que ela mais se parece com o Notion

Se a visualização em tabela resolve o “problema de gerenciamento”, a visualização em cartão resolve o “problema de exibição”.

Olhando para essa interface, você sente imediatamente que é diferente do Obsidian antigo. Assim que os cartões são dispostos, o conteúdo do cofre inteiro se transforma instantaneamente de uma “lista de arquivos” em um “painel de conteúdo”.

Esse modo é especialmente bom para:

Biblioteca de filmes
Biblioteca de livros
Biblioteca de imagens
Navegação estilo kanban de projetos
Pool de tópicos de artigos

Pessoalmente, acho que a parte mais valiosa da Base não é a tabela, mas o cartão. Porque muitas ferramentas fazem tabelas, mas o que faltava no Obsidian era justamente essa capacidade de “transformar notas em uma biblioteca visual de materiais”.

Se você quer fazer uma galeria de filmes parecida com a do Notion, a ideia é simples:

Cada filme tem sua própria nota
Adicione algumas propriedades básicas a cada nota
Prepare especificamente uma propriedade “Capa” para guardar a imagem do pôster
Depois, na visualização em cartão, defina a origem da imagem de capa como essa propriedade “Capa”

O resultado será muito próximo da exibição em galeria do Notion.

Exemplo prático completo: Monte uma galeria de filmes do zero

Vou usar o exemplo que acabei de fazer. Os arquivos são bem simples, apenas dois:

The Shawshank Redemption.md
Farewell My Concubine.md

O objetivo é claro: Fazer com que essas duas notas sejam exibidas como dois cartões de filme com pôsteres na Base.

Passo 1: Prepare duas notas de filme

A forma mais simples é um arquivo por filme. Por exemplo, crie duas notas em 00-Inbox:

The Shawshank Redemption
Farewell My Concubine

Não se preocupe em escrever conteúdo longo nesta etapa; mesmo que o arquivo só tenha o título, está tudo bem. Para a Base, o mais importante não é o corpo, mas as propriedades.

Passo 2: Adicione as propriedades “Capa” e “Categoria” às notas

Abra uma das notas, por exemplo, Farewell My Concubine.md, e na área “Propriedades da nota” no topo, adicione duas propriedades:

Capa
Categoria

Onde:

Capa é para o pôster do filme
Categoria é para marcar como “Filme”

Você pode fazer isso diretamente no Obsidian clicando em “Adicionar propriedade da nota”, sem precisar escrever YAML manualmente.

Aqui vai um ponto em que iniciantes costumam travar, então vou ser claro: O pôster na visualização em cartão não olha para imagens comuns inseridas no corpo; ele olha para a imagem na propriedade.

Em outras palavras, se você inserir o pôster no corpo, a Base pode não tratá-lo como a capa do cartão; mas se você colocar o pôster na propriedade Capa, ela vai ler corretamente.

Por exemplo, essa nota de filme acaba tendo essencialmente esta estrutura:

---
Cover: "[[05-Archive/Gallery/PixPin_2026-04-02_10-05-21.webp]]"
Category:
  - Movie
---

Você não precisa escrever manualmente assim, porque o painel de propriedades do Obsidian faz isso para você. Mas saber como é por baixo ajuda na hora de resolver problemas.

Passo 3: Crie um arquivo Base dedicado

Depois, clique com o botão direito na pasta à esquerda, crie um novo banco de dados, e você terá um arquivo .base. Estou usando Demo-Base.base aqui.

Você pode pensar nesse arquivo como a “sala de exposição em si”, enquanto as duas notas de filme são as “peças expostas”. A Base é responsável pela exibição; os dados reais continuam armazenados em suas respectivas notas Markdown.

Passo 4: Reduza o escopo para apenas esses dois filmes

Muitas pessoas têm um problema ao usar a Base pela primeira vez: quando abrem, todas as notas do cofre inteiro aparecem. Então essa etapa é essencial — filtrar o escopo primeiro.

Você pode clicar em “Filtrar” no canto superior direito da Base para manter apenas o conteúdo que deseja mostrar. Por exemplo:

Apenas notas de uma determinada pasta
Apenas notas com uma determinada tag
Apenas notas onde categoria é igual a “Filme”
Ou, como no meu demo, diretamente apenas esses dois arquivos específicos

Para iniciantes, recomendo usar “escopo de pasta” ou “categoria = Filme” primeiro, pois são mais intuitivos.

Passo 5: Mude para a visualização em cartão e especifique a origem da capa

Este é o passo mais crítico. Depois de mudar para a visualização em cartão, você precisa dizer à Base: Qual propriedade de imagem deve ser usada para a capa do cartão.

Aqui, selecione a Capa que criamos anteriormente.

Se esse passo estiver correto, os cartões se transformam instantaneamente de blocos de texto simples em uma verdadeira galeria de pôsteres de filmes.

Aqui vai outro ponto que pode confundir iniciantes. Quando você clica em “Propriedades” no canto superior direito, está selecionando quais campos exibir abaixo do cartão, como Nome, Categoria, etc. Mas se o pôster aparece ou não não é controlado aqui.

O pôster faz parte da capa do cartão, e sua origem é a propriedade Capa que você especificou separadamente na visualização em cartão. Então, mesmo que você não marque Capa no menu “Propriedades”, o pôster acima ainda será exibido normalmente.

Em outras palavras, existem dois conjuntos de configurações:

Capa: controla o pôster no topo do cartão
Nome, Categoria: controlam as informações de texto exibidas abaixo do cartão

Veja, neste ponto, Farewell My Concubine e The Shawshank Redemption se tornaram uma galeria de filmes muito parecida com a do Notion. O topo do cartão mostra o pôster, e a parte inferior mostra o nome do arquivo e as propriedades. Mesmo que você tenha apenas dois filmes agora, já consegue ver o valor desse padrão — conforme você adicionar mais filmes depois, toda a biblioteca vai crescer e se tornar um verdadeiro acervo de mídia.

Passo 6: O que mais você pode adicionar depois?

Depois que você tiver “Capa + Categoria” funcionando, o resto é simples. Você pode continuar adicionando estas propriedades a cada filme:

Ano
Diretor
País/Região
Avaliação
Assistido ou não
Número de vezes que reassistiu
Crítica em uma linha

Então:

A visualização em cartão cuida de “ficar bonito”
A visualização em tabela cuida de “gerenciamento fácil”

Essa é a forma mais confortável de usar a Base: Separar exibição e gerenciamento para o mesmo conjunto de conteúdo.

Por que esse exemplo é adequado para iniciantes?

Porque ele quase não tem barreira. Você não precisa aprender fórmulas primeiro, não precisa aprender Dataview primeiro, não precisa mexer com modelos complexos. Você só precisa entender três coisas:

Um filme = uma nota
Não coloque o pôster apenas no corpo; coloque-o em uma propriedade
A origem do pôster na visualização em cartão deve ser definida como a propriedade “Capa”

Depois que você entender essas três coisas, bibliotecas de filmes, bibliotecas de livros, bibliotecas de jogos, bibliotecas de fotos de viagem — todas seguem o mesmo padrão.

E como os arquivos subjacentes ainda são Markdown, sua biblioteca de filmes não fica essencialmente presa em um banco de dados, mas é um conjunto real de notas locais. Depois, se você quiser migrar, fazer backup ou entregar para IA processar, é muito mais confortável do que uma plataforma fechada.

Filtrar, Ordenar, Propriedades: Esses três são o núcleo da Base

Muitas pessoas, ao abrir a Base pela primeira vez, ficam olhando para os botões de alternância de visualização “Tabela / Cartão / Lista” por um bom tempo. Mas o que realmente determina se essa coisa é útil não é a visualização em si, mas os três botões no canto superior direito:

Filtrar: decide quem entra
Ordenar: decide quem você vê primeiro
Propriedades: decide o que você vê

Depois que você entender esses três, a Base vai se transformar de um “novo recurso” em uma “ferramenta que realmente funciona”.

Por exemplo, no meu demo, a visualização em cartão é ótima para uma galeria de conteúdo, então você pode usar filtros para excluir certas pastas e manter apenas o conteúdo adequado para exibição. Isso faz com que os cartões fiquem muito mais limpos.

Já a visualização em tabela é melhor para expor campos, facilitando a verificação e o ajuste em lote.

Em outras palavras: O mesmo conjunto de arquivos, visualizações diferentes não são duplicação, mas divisão de trabalho.

É aqui que a Base mais se parece com o Notion, mas ainda assim é muito Obsidian.

Dá para usar como um livro-caixa?

Dá, mas na minha opinião: É possível, mas pode não ser o mais confortável.

Se o seu hábito de livro-caixa é “um registro equivale a uma entrada independente”, então a Base é adequada. Você pode adicionar propriedades como valor, data, categoria, forma de pagamento a cada registro, depois filtrar, ordenar e calcular na tabela. A lógica funciona.

Mas se você está acostumado a registrar um fluxo contínuo em um único arquivo Markdown, a Base é menos conveniente. Porque muitos recursos da Base pressupõem que: uma linha de conteúdo corresponde a um arquivo.

Então, para mim, atualmente ela é melhor para:

Bibliotecas de imagens
Bibliotecas de livros
Bibliotecas de filmes
Pools de materiais de artigos
Listas de projetos

Do que para registros de transações de alta frequência. Essa também é minha visão de longa data sobre o Obsidian: Não tente fazer tudo de uma vez desde o início.

A Base é certamente poderosa, mas a melhor forma de usá-la não é forçá-la a substituir tudo, mas colocá-la no lugar certo.

Como sugiro que você comece a usar

Se você ainda não usou a Base, sugiro não construir um sistema enorme de imediato. A melhor forma de começar são na verdade duas coisas:

Primeiro, faça uma galeria. Por exemplo, filmes, livros, capas de artigos, fotos de viagem, materiais de coleção — tudo isso é ótimo para a visualização em cartão. Você vai entender imediatamente o valor da Base.

Segundo, faça uma tabela leve. Por exemplo, listas de projetos, materiais para organizar, registros de leitura. Então você vai usar naturalmente ordenação, filtragem e exibição de propriedades.

Depois que você passar por esses dois cenários, vai basicamente conhecer a Base.

Resumo

Com o lançamento da Base, o Obsidian deixou de ser apenas um “aplicativo de anotações que escreve Markdown” e começou a ter um pouco de cara de banco de dados real. Mas sua vantagem principal não é competir com o Notion sobre quem é mais parecido com um banco de dados, mas sim: Ele dá aos seus arquivos locais, pela primeira vez, uma visualização de banco de dados suficientemente conveniente.

Isso é muito importante. Porque antes, muitos conteúdos não eram ingerenciáveis, mas difíceis de gerenciar; não eram invisíveis, mas difíceis de visualizar. Agora com a Base, muitos cenários que antes exigiam plugins finalmente podem ser feitos diretamente.

O que aprendemos hoje:

A essência da Base é adicionar uma camada de visualização de banco de dados aos arquivos Markdown existentes
Criar uma é simples: clique com o botão direito em uma pasta à esquerda para criar um novo banco de dados
O mais importante na Base não é o visual, mas as três operações principais: filtrar, ordenar e propriedades
Tabelas são boas para gerenciamento, listas para navegação rápida, e cartões são melhores para galerias de filmes e acervos de mídia
É ótima para bancos de dados orientados a exibição, mas não necessariamente para todos os cenários de transações de alta frequência

Pontos-chave:

O arquivo .base em si não são dados, mas uma configuração de visualização de banco de dados
Uma linha de conteúdo geralmente corresponde a um arquivo de nota real
A visualização em cartão é a mais próxima do efeito de galeria do Notion
Para começar mais rápido, primeiro faça uma galeria de filmes, depois uma tabela leve
Não pense em fazer tudo de uma vez desde o início; primeiro use a Base para os cenários em que ela é melhor

Obsidian Canvas: Organize Ideias Visualmente

Mon, 01 Jan 0001 00:00:00 +0000

Cobrimos o planejamento de pastas — usar algumas pastas simples para gerenciar um sistema de anotações. Agora, vamos explorar outro plugin principal que vem com o Obsidian: Canvas.

O que é o Canvas, para que serve e para que não serve

De forma simples, o Canvas é uma tela infinita.

Anotações comuns são lineares — você escreve de cima para baixo, com conteúdo em ordem sequencial. O Canvas é diferente; é bidimensional, sem limites. Você pode arrastar notas, imagens, links da web e cartões de texto, e depois usar linhas para estabelecer relações entre eles.

Cenários onde o Canvas é útil:

Detalhamento de projetos complexos: Divida um grande objetivo em várias subtarefas, usando linhas para indicar dependências
Mapa de relacionamento de conhecimento: Quando há muitos conceitos em uma área, use o Canvas para visualizar como eles se conectam
Anotações visuais de livros: Os argumentos centrais de um livro, casos de apoio e contrapontos ficam muito mais intuitivos quando dispostos visualmente em comparação com anotações lineares
Fluxogramas / Diagramas de arquitetura: Fluxos de produto, arquiteturas técnicas, fluxos de trabalho — desenhá-los é mais fácil de entender do que escrevê-los

Cenários onde o Canvas não é adequado:

Use notas comuns para conteúdo linear. Não use o Canvas só por usar.

Se você está escrevendo um artigo, fazendo a ata de uma reunião ou organizando uma lista — apenas use arquivos .md. Abrir o Canvas adiciona uma camada extra de operação. O valor do Canvas está em conteúdo que requer consciência espacial; use-o apenas quando houver relações complexas entre o conteúdo.

Ativando o Plugin Principal Canvas

O Canvas é um plugin principal nativo do Obsidian, então não é necessária instalação. Ele vem desativado por padrão, então você precisa ativá-lo manualmente.

Caminho: Configurações → Plugins principais → Encontre “Canvas” → Ative o interruptor à direita.

Após ativar, um ícone do Canvas aparecerá na barra lateral esquerda. Clique nele para criar um novo arquivo Canvas.

Criando e Usando o Canvas

Como Criar um Novo Canvas

Existem três maneiras:

Paleta de comandos: Cmd+P (Mac) ou Ctrl+P (Windows), pesquise por “Novo Canvas”, pressione Enter
Barra lateral esquerda: Após ativar o plugin Canvas, o ícone do Canvas aparece na barra lateral esquerda; clique nele para criar um novo

Após a criação, um arquivo .canvas é gerado (mais sobre isso adiante).

Operações Comuns e Atalhos

A lógica de operação do Canvas é semelhante à de softwares de desenho comuns, então é fácil de aprender:

Operação	Atalho
Criar um novo cartão de texto	Clique duplo em espaço vazio
Sair da edição do cartão	Esc
Navegar pela tela	Espaço + arrastar, ou botão do meio do mouse arrastar
Zoom na tela	Ctrl/Cmd + roda do mouse
Ajustar todo o conteúdo à tela	Shift+1
Ajustar o conteúdo selecionado à tela	Shift+2
Excluir um cartão	Selecione e pressione Backspace ou Delete
Conectar dois cartões	Passe o mouse sobre a borda de um cartão, arraste a partir do ponto que aparece

As duas mais comuns são: clique duplo para criar um cartão e arraste a partir do ponto na borda para conectar.

Fluxo de Trabalho com Teclado: Criando Ramificações sem Sair do Teclado

O Canvas também suporta um fluxo de trabalho puro com teclado, ideal para brainstorming rápido e criação contínua de ramificações.

Navegação básica (quando não estiver no modo de edição):

Operação	Atalho
Alternar seleção para o próximo/anterior cartão	Tab / Shift+Tab
Mover para um cartão conectado adjacente	← → ↑ ↓
Entrar no modo de edição do cartão selecionado	Enter
Sair do modo de edição, retornar à seleção de cartões	Esc
Selecionar todos os cartões	Ctrl/Cmd + A
Excluir cartão selecionado	Backspace ou Delete

Criando ramificações: Selecione um cartão (não no modo de edição), então mova o mouse para a borda do cartão. Há pontos de conexão circulares em todos os quatro lados. Arraste um para uma área vazia — não sobre um cartão existente, mas para o espaço em branco — solte, e um menu aparecerá. Selecione “Novo cartão de texto”, e o novo cartão é automaticamente criado e conectado ao cartão atual.

Fluxo de trabalho com teclado + mouse para criar múltiplas ramificações paralelas:

Clique duplo em espaço vazio para criar um cartão pai, insira o conteúdo, pressione Esc para sair da edição
Com o cartão selecionado, arraste a partir do ponto na borda direita → crie o cartão filho 1, insira o conteúdo, pressione Esc
Use a tecla de seta ← para retornar ao cartão pai
Arraste novamente a partir do ponto na borda direita → crie o cartão filho 2, insira o conteúdo, pressione Esc
Repita os passos 3–4 para gerar rapidamente um conjunto de ramificações filhas paralelas

A chave deste fluxo de trabalho é: use o mouse para criar cartões, use o teclado para entrada e alternância, com baixo custo de troca entre os dois. Se você quiser evitar completamente o mouse, o Canvas atualmente não consegue fazer isso — o Obsidian ainda não suporta a criação pura por teclado de cartões conectados. Para um mapa mental puro por teclado, você pode esperar pelo próximo capítulo sobre Excalidraw, ou usar uma ferramenta dedicada de mapas mentais.

Adicionando Coisas ao Canvas

Você pode adicionar mais do que apenas cartões de texto ao Canvas:

Cartões de texto: Clique duplo em espaço vazio, digite diretamente, suporta formato Markdown. Títulos, listas, negrito — igual às notas comuns.

Arquivos de nota existentes: Arraste da árvore de arquivos diretamente para o Canvas, ou clique com o botão direito em espaço vazio no Canvas → “Adicionar arquivo do cofre”. Após arrastar, o conteúdo da nota é pré-visualizado no cartão, e você pode editá-lo diretamente.

Um parágrafo específico de uma nota: Selecione o parágrafo desejado na nota, então arraste-o para o Canvas — apenas aquele conteúdo é adicionado, não o arquivo inteiro. Ótimo para detalhar anotações de livros.

Imagens: Arraste arquivos de imagem da árvore de arquivos ou de pastas do sistema para o Canvas; eles são exibidos diretamente.

Links da web: Cole um link no Canvas, clique com o botão direito e selecione “Converter em cartão de link”, que mostra o título da página e uma prévia.

Ponto Chave! Usando IA para Desenhar Canvas

O Canvas pode ser desenhado manualmente, mas há uma maneira ainda mais fácil: deixe a IA gerar para você.

Contexto

Primeiro, uma breve introdução ao Claude Code — a ferramenta CLI de programação com IA da Anthropic. Ela pode ser estendida com Skills (o uso detalhado será abordado na Parte 5 deste livro sobre colaboração com IA). O desenvolvedor do Obsidian, kepano, criou um conjunto de obsidian-skills especificamente para o Claude Code, incluindo um chamado json-canvas que ensina o Claude Code a criar e editar arquivos .canvas.

URL: https://github.com/kepano/obsidian-skills/tree/main/skills/json-canvas

Método de Instalação

Execute no terminal:

git clone https://github.com/kepano/obsidian-skills.git ~/.claude/skills/obsidian-skills

Ou você pode abrir o site para baixá-lo diretamente, depois criar esta pasta e colocá-la no diretório de skills.

Método de Uso

No Claude Code, digite /json-canvas, selecione este Skill, pressione Tab, então descreva em linguagem natural o que você quer desenhar. O Claude Code gerará diretamente um arquivo .canvas no seu cofre do Obsidian.

Demonstração Prática

Usei a estrutura de pastas do capítulo sobre planejamento de pastas como demonstração. Disse ao Claude Code: “Desenhe a estrutura de pastas do capítulo de planejamento de pastas como um Canvas, mostrando a função e as relações de fluxo de cada pasta.”

Após ler o artigo, o Claude Code gerou diretamente um arquivo .canvas e o colocou na 00 Inbox. O conteúdo do arquivo está no formato JSON Canvas padrão — cada pasta corresponde a um cartão, com codificação de cores e setas indicando relações de fluxo:

Você pode ver que a 00 Inbox serve como ponto de entrada, o conteúdo organizado flui para 01 Notes e 04 Output, e o conteúdo de 01 Notes então flui para 04 Output — todo o fluxo é claro de relance. Essa relação exigiria várias rodadas de explicação em texto, mas em um diagrama, é compreendida em três segundos.

Esta é uma combinação prática de IA + Canvas: jogue suas notas ou artigos diretamente para o Claude Code, deixe-o extrair automaticamente a estrutura e desenhar o diagrama de relacionamento, o que é muito mais rápido do que criar cartões e arrastar conexões manualmente.

Sobre o Formato .canvas, Uma Coisa a Esclarecer

Arquivos Canvas não estão no formato .md; eles estão no formato .canvas.

Arquivos .canvas são arquivos de texto simples no formato JSON, armazenando a posição, tamanho e conteúdo de cada cartão, bem como as conexões entre cartões. Eles são paralelos aos arquivos .md — na árvore de arquivos, os arquivos .canvas aparecem separadamente, armazenados separadamente dos arquivos de nota.

Isso significa: O Canvas precisa ser gerenciado separadamente. Você não pode escrever texto e incorporar um Canvas em um único arquivo .md — o Canvas é um arquivo separado, o texto é outro arquivo, existindo independentemente.

A propósito, JSON Canvas não é um formato proprietário exclusivo do Obsidian; é um padrão aberto (licença MIT) e já é suportado por muitas ferramentas. Mas a questão de “precisar gerenciar separadamente” permanece.

Resumo

O que aprendemos hoje:

Canvas = tela infinita: Adequado para conteúdo que requer consciência espacial e construção de relacionamentos; não force para conteúdo linear
Como ativar: Configurações → Plugins principais → Canvas → Ative o interruptor
Operações principais: Clique duplo para criar um cartão, arraste a partir de pontos na borda para conectar, Espaço+arrastar para navegar pela tela
Fluxo de trabalho com teclado: Tab/Shift+Tab para alternar cartões, ↑↓←→ para mover, Enter para editar, Esc para sair; criar cartões conectados requer arrastar pontos para espaço vazio; criação pura por teclado ainda não é suportada
O que você pode adicionar ao Canvas: Cartões de texto, notas existentes, parágrafos de notas, imagens, links da web
Skill json-canvas: Deixe o Claude Code ler notas e gerar automaticamente arquivos .canvas, muito mais rápido do que desenhar manualmente
Observação sobre formato: O Canvas salva como .canvas (JSON), não .md, e precisa ser gerenciado separadamente

Plugin de Comandos: Personalize Seu Menu de Contexto

Mon, 01 Jan 0001 00:00:00 +0000

Já abordei muitas operações e mencionei comandos com frequência, mas sei que você pode não estar acostumado com esse fluxo de trabalho. Para tarefas comuns, podemos usar o plugin Commander para adicioná-las ao nosso menu de contexto, tornando o acesso muito mais conveniente.

Em termos simples: pegue os comandos que você usa com frequência e fixe-os diretamente no seu menu de contexto. Clique com o botão direito a qualquer momento para acessá-los, sem precisar abrir a Paleta de Comandos toda vez.

Instale o Plugin Commander

Abra as Configurações, vá em Plugins da Comunidade, pesquise por command, encontre o plugin Commander e instale-o.

Existem vários plugins com “command” no nome. Procure por Commander de Johnny e phibr0, com mais de 470 mil downloads. Certifique-se de pegar o correto.

Abra as Configurações do Plugin

Após a instalação, vá para a lista de Plugins Instalados, encontre Commander e clique no ícone de engrenagem à direita para abrir suas configurações.

Dentro, você verá várias abas: Geral, Barra Lateral Esquerda, Página Inicial, Barra de Status, Menu do Editor… Queremos personalizar o menu de contexto, então clique na aba Menu do Editor.

Já existem alguns comandos padrão. Role até o final e clique no botão Adicionar Comando.

Pesquise e Selecione um Comando

Após a caixa de pesquisa aparecer, primeiro digite uma palavra-chave, depois aguarde a lista de comandos aparecer antes de selecionar.

Você deve digitar uma palavra-chave primeiro, depois selecionar na lista. Não clique na lista enquanto ela estiver vazia, ou você pode não encontrar o comando desejado — há muitos comandos, e a exibição padrão é incompleta.

Nomeie o Comando

Após selecionar um comando, uma caixa de diálogo aparecerá pedindo para você dar um nome personalizado. Recomenda-se usar um nome descritivo para que você possa identificá-lo facilmente no menu de contexto.

(Às vezes, antes desta etapa, pode ser solicitado que você escolha um ícone. Escolha qualquer um ou pule — isso não afeta a funcionalidade.)

Veja o Resultado

Feito isso, clique com o botão direito em qualquer lugar do editor, e o comando recém-adicionado aparecerá no menu.

Pronto — seis passos e está feito. De agora em diante, basta clicar com o botão direito para usar o comando, muito mais rápido do que abrir a Paleta de Comandos.

Resumo

Este plugin é muito simples de usar, mas pode aumentar significativamente sua eficiência diária. O Obsidian tem centenas de comandos. Fixe os que você usa com mais frequência no menu de contexto e acione-os com um clique direito, economizando o ciclo repetitivo de abrir-pesquisar-executar.

O que você aprendeu hoje:

O plugin Commander pode adicionar qualquer comando do Obsidian ao menu de contexto, barra lateral, barra de status e outros locais.
Ao adicionar um comando, você deve digitar uma palavra-chave primeiro antes de selecionar, caso contrário pode não encontrá-lo.
Dê nomes descritivos aos seus comandos para facilitar a identificação no menu de contexto.

Pontos-chave:

Ao pesquisar um comando, digite primeiro, depois selecione — a ordem importa.
O Commander pode personalizar não apenas o menu de contexto, mas também vários outros locais, como a barra lateral e a barra de status.
Nomes descritivos são muito mais amigáveis do que os nomes longos em inglês padrão dos comandos.

Plugins do Obsidian: O Verdadeiro Universo de Extensões

Mon, 01 Jan 0001 00:00:00 +0000

Já cobrimos o básico do Obsidian — criar cofres, escrever notas, usar links bidirecionais e incorporar imagens. Agora vamos mergulhar na parte mais empolgante do Obsidian: plugins.

O que são plugins?

Plugins são complementos que estendem a funcionalidade do Obsidian. O Obsidian em si oferece um ambiente limpo para anotações, mas você pode torná-lo muito mais poderoso instalando plugins — adicione um calendário, um quadro Kanban, um assistente de IA, o que quiser.

Os plugins do Obsidian vêm em dois tipos: plugins principais e plugins de terceiros (também chamados de plugins da comunidade).

Plugins Principais

Os plugins principais já vêm embutidos no Obsidian por padrão. Vá em Configurações → Plugins principais para ver a lista.

Eles são desenvolvidos pela equipe do Obsidian, por exemplo:

Pesquisar: Pesquisa o conteúdo das notas globalmente
Visualização em grafo: Visualiza os links entre as notas
Notas diárias: Cria automaticamente uma nota diária
Estrutura de tópicos: Gera um sumário baseado nos níveis de título

Alguns plugins principais vêm ativados por padrão, outros não. Você pode ativá-los ou desativá-los conforme necessário.

Características: Mantidos oficialmente, estáveis e seguros, mas limitados em quantidade.

Plugins de Terceiros (Plugins da Comunidade)

Os plugins de terceiros são contribuídos por desenvolvedores do mundo todo. Quase qualquer funcionalidade que você imaginar já foi criada por alguém.

Características: Variedade enorme, funcionalidades ricas, mantidos por desenvolvedores da comunidade.

Se os plugins principais não fizerem o que você precisa, é bem provável que você encontre uma solução no mercado de plugins da comunidade.

Como Instalar Plugins de Terceiros

Dois métodos.

Método 1: Instalar pelo Mercado de Plugins da Comunidade (Recomendado)

A maneira mais fácil, apenas três passos.

Passo 1: Desative o Modo Restrito.

Vá em Configurações → Plugins de terceiros. Você verá que o “Modo Restrito” está ativado. Clique em “Desativar” e confirme.

O Obsidian ativa o Modo Restrito por padrão por segurança — afinal, plugins de terceiros são códigos escritos por outras pessoas. No entanto, os plugins do mercado da comunidade passam por revisão da equipe oficial, então é seguro usá-los.

Passo 2: Navegue e Instale.

Após desativar o Modo Restrito, clique no botão “Navegar” para abrir o mercado de plugins da comunidade. Procure o plugin desejado, encontre-o e clique em “Instalar”.

Passo 3: Ative.

Após a instalação, o plugin não será ativado automaticamente. Volte para Configurações → Plugins de terceiros, encontre o plugin que acabou de instalar e ative o interruptor.

Alguns plugins funcionam logo após a ativação, enquanto outros precisam de configuração. Aqueles com um ícone de engrenagem ao lado podem ser configurados — clique nele para ver as opções.

Método 2: Instalação Manual (Download do GitHub)

Alguns plugins ainda não foram listados no mercado da comunidade (ainda em revisão), ou você pode querer usar a versão de desenvolvimento mais recente de um plugin. Nesses casos, você precisará instalar manualmente. Este método geralmente não é recomendado para iniciantes, mas é bom saber.

Passo 1: Baixe os arquivos do plugin.

Vá para a página do plugin no GitHub, encontre a seção Releases e baixe a versão mais recente. Normalmente você precisará de três arquivos:

main.js
manifest.json
styles.css (alguns plugins não têm este arquivo; se não tiver, ignore)

Passo 2: Coloque-os na pasta de plugins.

Na pasta do seu cofre, localize o diretório .obsidian/plugins/ (crie-o se não existir). Crie uma pasta dentro dele e coloque os arquivos baixados lá:

Your Vault/
├── .obsidian/
│   └── plugins/
│       └── plugin-name/
│           ├── main.js
│           ├── manifest.json
│           └── styles.css

.obsidian é uma pasta oculta. No Mac, pressione Cmd + Shift + . para mostrar arquivos ocultos. No Windows, marque “Mostrar arquivos ocultos” nas opções de pasta.

Se você já instalou plugins de terceiros, pode clicar no botão mostrado na imagem para abrir esta pasta.

Passo 3: Ative.

Volte ao Obsidian, Configurações → Plugins de terceiros, atualize a lista e o plugin que você colocou aparecerá. Ative o interruptor para habilitá-lo.

O Método 1 geralmente é suficiente. O Método 2 é para usuários avançados ou para quem quer testar as funcionalidades mais recentes.

Como Usar as Funcionalidades dos Plugins

Após instalar e ativar um plugin, como acessar suas funcionalidades? Duas maneiras.

Método 1: Botões de Atalho na Barra Lateral Esquerda

A fileira vertical de pequenos ícones à esquerda do Obsidian são entradas de atalho para várias funcionalidades.

Muitos plugins adicionam um ícone aqui após a instalação. Clique nele para abrir a funcionalidade correspondente. Por exemplo, após instalar o plugin Recent Files, um ícone de relógio aparece aqui; clicando nele, você vê uma lista de arquivos editados recentemente.

Método 2: Paleta de Comandos (Recomendado)

Pressione Ctrl/Cmd + P para abrir a paleta de comandos, digite a ação que deseja realizar e pressione Enter.

Quase todas as funcionalidades dos plugins podem ser acessadas pela paleta de comandos. Não lembra onde está uma funcionalidade? Basta pressionar Ctrl/Cmd + P e pesquisar. Por exemplo, se quiser limpar imagens não utilizadas, não precisa procurar um botão — basta digitar “Limpar” na paleta de comandos e você encontrará a ação correspondente.

A paleta de comandos é o ponto de entrada universal do Obsidian. Basta lembrar de Ctrl/Cmd + P.

Quatro Plugins Essenciais para Iniciantes

A biblioteca de plugins do Obsidian é enorme, mas você não precisa instalar muitos no começo. Aqui estão quatro que eu pessoalmente uso o tempo todo, cada um resolvendo um problema real.

1. Recent Files — Lista de Arquivos Recentes

O Obsidian não tem uma lista de “arquivos recentes” por padrão. Conforme suas notas crescem, encontrar o arquivo que você acabou de editar significa vasculhar pastas.

Após instalar: Um novo painel aparece na barra lateral esquerda, listando seus arquivos abertos recentemente em ordem cronológica. Clique em um para ir até ele.

2. Easy Typing — Formatação Automática

Usuários vindos do Notion, Word ou outras plataformas podem não estar familiarizados com a sintaxe Markdown. Ao misturar chinês e inglês, a formatação pode ficar inconsistente, e adicionar espaços manualmente é tedioso. Escrever tabelas, adicionar realces coloridos e outras operações Markdown têm sintaxe complexa.

Mas este plugin — se você já usou o Word, vai achá-lo familiar.

Após instalar:

Adiciona automaticamente espaços entre texto em chinês e inglês — digite “我用Obsidian” e ele se torna “我用 Obsidian”, melhorando instantaneamente a legibilidade.
Melhorias de edição — selecione o texto e pressione uma tecla de símbolo (como *) para envolvê-lo rapidamente, deixando-o em negrito sem digitar dois asteriscos manualmente.
Conversão inteligente de símbolos de largura total — converte automaticamente pontuação de largura total para meia largura em ambientes de código, para que você não precise alternar o método de entrada.

Este plugin tem muitas opções; você pode ativá-las conforme sua necessidade.

3. Clear Unused Images — Limpar Imagens Não Utilizadas

Ao escrever notas, você frequentemente tira capturas de tela e insere imagens. Mas às vezes você exclui uma seção, e as imagens que ela referenciava se tornam “órfãs” — nenhuma nota as referencia mais, mas os arquivos de imagem ainda ocupam espaço. Com o tempo, sua pasta de anexos fica cheia de imagens inúteis.

Após instalar: Execute uma vez, e ele escaneará todo o seu cofre, encontrará todas as imagens não referenciadas por nenhuma nota e as limpará para você.

Como usar: Clique no botão de atalho na barra lateral esquerda, ou pressione Ctrl/Cmd + P para abrir a paleta de comandos, digite “Clear Unused Images” e pressione Enter.

4. Open In New Tab — Abrir Arquivos em Nova Aba

Comportamento padrão do Obsidian: quando você clica em um arquivo na lista de arquivos, ele substitui a aba atual. Você está editando A, quer verificar B, clica em B, e A desaparece — agora você tem que voltar e encontrá-lo.

Após instalar: Clicar em qualquer arquivo na lista de arquivos o abre em uma nova aba sem sobrescrever o conteúdo atual. Mesma lógica de um navegador. Se o arquivo já estiver aberto, ele automaticamente pula para aquela aba existente em vez de abrir uma duplicata.

Funciona imediatamente após a instalação, sem necessidade de configuração.

Resumo

O que você aprendeu hoje:

Dois tipos de plugins: Plugins principais (embutidos) e plugins de terceiros (contribuídos pela comunidade)
Dois métodos de instalação: Diretamente do mercado da comunidade (recomendado) ou manualmente pelo GitHub
Duas maneiras de usá-los: Botões de atalho na barra lateral esquerda, ou a paleta de comandos Ctrl/Cmd + P (recomendado)
Quatro plugins essenciais:
- Recent Files — Encontre rapidamente arquivos editados recentemente
- Easy Typing — Melhorias de edição
- Clear Unused Images — Limpe imagens não referenciadas
- Open In New Tab — Abra arquivos em novas abas

Pontos principais:

Mais plugins nem sempre é melhor; instale apenas o que você precisa
Comece com esses quatro e adicione mais conforme necessário
Lembre-se de Ctrl/Cmd + P — é o ponto de entrada universal do Obsidian

Por que Recomendo o Obsidian

Mon, 01 Jan 0001 00:00:00 +0000

Obsidian é uma ferramenta que vale a pena considerar para qualquer pessoa que leva o conhecimento a sério.

Deixe-me começar com uma afirmação ousada:

Se eu pudesse usar apenas um aplicativo de anotações pelo resto da vida, escolheria o Obsidian.

O que é o Obsidian?

Em resumo: o Obsidian é um aplicativo de anotações em Markdown com foco em armazenamento local.

Vamos detalhar isso em três pontos principais:

Armazenamento local: suas anotações são salvas no seu próprio computador como arquivos .md. Sem necessidade de internet, sem dependência de servidor.
Markdown: a sintaxe padrão do Markdown funciona diretamente no Obsidian. Cada nota que você escreve é um arquivo Markdown padrão.
Aplicativo de anotações: mas é mais do que apenas anotações. Você pode construir uma base de conhecimento, escrever artigos, gerenciar projetos ou até usá-lo como editor de blog.

Você pode pensar no Obsidian como um editor local poderoso, projetado especificamente para Markdown.

Espere, por que falar sobre aplicativos de anotações?

Boa pergunta. Por que gastar tempo em um guia sobre Obsidian discutindo “por que escolher um aplicativo de anotações”?

Isso importa muito.

Primeiro, a IA precisa de uma base de conhecimento local.

Suas conversas com ChatGPT, Claude e outros ficam armazenadas em servidores de terceiros. Se o serviço for descontinuado, sua conta for banida ou o histórico de chat for limpo — tudo se perde. Você precisa de um lugar local para preservar conversas e conteúdos valiosos.

Além disso, a IA precisa ser “alimentada”. Quanto mais material organizado você der à IA, melhores serão os resultados. Uma biblioteca de notas local bem organizada é o arsenal mais poderoso para sua colaboração com a IA.

Segundo, a produção é a parte mais crucial da acumulação de conhecimento.

O estilo de aprendizado de muitas pessoas é: ler → favoritar → achar que sabe → na verdade não lembrar de nada.

Ler sem escrever é o mesmo que não aprender. Você precisa escrever as coisas, reorganizá-las com suas próprias palavras, para que o conhecimento realmente se torne seu. É isso que o Obsidian faz — ele ajuda você a transformar informações fragmentadas em conhecimento sistemático.

Estou usando o Obsidian para gerenciar todo o meu material agora. O capítulo que você está lendo foi escrito no Obsidian.

Portanto, um aplicativo de anotações não é o oposto da IA; é a infraestrutura para o seu fluxo de trabalho com IA.

Por que o Obsidian?

Existem muitos aplicativos de anotações por aí: Notion, Evernote, Feishu Docs, Yuque… Por que recomendar especificamente o Obsidian?

Muitas pessoas usam o Notion, e ele é realmente bom. Mas após a comparação, ainda escolhi o Obsidian.

	Obsidian	Notion
Armazenamento de Dados	Arquivos locais, seu próprio disco rígido	Nuvem, armazenado nos servidores do Notion
Formato de Arquivo	Markdown padrão (arquivos .md)	Formato proprietário, exportável mas com perdas
Uso Offline	Totalmente suportado	Suportado, mas experiência mediana
Velocidade	Muito rápido (operações locais)	Depende da velocidade da internet
Plano Gratuito	Funcionalidades principais completamente gratuitas	Plano gratuito tem limitações
Ecossistema de Plugins	Mais de 2000 plugins da comunidade	Principalmente integrações oficiais
Integração com Ferramentas de IA	Arquivos locais, IA pode ler/escrever diretamente	Serviço pago oficial
Segurança dos Dados	Os dados estão em suas mãos	Os dados estão nas mãos de terceiros

O ponto mais crítico: os dados estão em suas próprias mãos.

As anotações do Notion ficam armazenadas nos servidores dele. Se o serviço for descontinuado, as políticas mudarem ou eles começarem a cobrar de repente — suas anotações se tornam reféns.

Também sou um usuário pesado do Notion, mas depois de colocar um romance de 130.000 palavras em uma página e acabar não conseguindo abri-la ou exportá-la, percebi que o local é realmente seu.

Claro, o Notion tem seus pontos fortes únicos e pode complementar o Obsidian. Falaremos sobre isso mais tarde.

Os dados do Obsidian são apenas uma pasta no seu computador. Mesmo que o software Obsidian feche amanhã, suas anotações permanecem — você pode abri-las com qualquer editor de texto.

Sua base de conhecimento é um dos seus ativos digitais mais importantes. Não a deixe nas mãos de terceiros.

Cinco Vantagens Principais

1. Links Bidirecionais: “Hiperlinks” Entre Notas

Este é o recurso mais famoso do Obsidian.

Aplicativos de anotações comuns apenas registram notas, sem conexões entre elas. Mas o conhecimento real não é isolado — economia e psicologia se cruzam, o pensamento de programação pode ser aplicado à escrita, um artigo que você leu ontém pode se relacionar com uma ideia da semana passada.

Os links bidirecionais (backlinks) do Obsidian permitem que você referencie outra nota a partir de qualquer nota. No modo de leitura, os backlinks não mostram os colchetes [[]], apenas uma mudança na cor da fonte, então você não precisa se preocupar com a aparência:

Today I learned about [[Feynman Technique]], the core idea is to test your understanding by teaching someone else.

Técnica de Feynman se torna um link clicável que leva você àquela nota. O que é ainda mais poderoso — na nota “Técnica de Feynman”, você também pode ver quais notas fizeram link para ela. O valor dos backlinks: suas notas não são mais documentos isolados, mas uma rede de conhecimento interconectada. Quanto mais você escreve, mais densa a rede se torna, e mais você descobre conexões que não havia notado antes.

Você pode até ver as relações entre todas as suas notas na visualização em grafo, como uma galáxia!

2. Armazenamento Local: Dados Sempre em Suas Mãos

Como mencionado anteriormente, as notas do Obsidian são apenas arquivos .md em uma pasta.

Isso significa:

Não se perdem — você pode fazer backup de qualquer forma (iCloud, OneDrive, até um pendrive)
Sem dependência de fornecedor — ao trocar de aplicativo, basta mover a pasta
IA pode ler e escrever diretamente — isso é extremamente importante, falaremos mais sobre isso depois

3. Ecossistema de Plugins: Qualquer Recurso que Você Precisar

O Obsidian tem mais de 2.000 plugins da comunidade. Quase qualquer necessidade que você possa imaginar já foi atendida:

Plugin de Calendário: gerencie notas diárias e diários por data
Plugin Kanban: transforme notas em um quadro de gerenciamento de tarefas
Plugin de Banco de Dados: dê ao Obsidian capacidades de banco de dados semelhantes ao Notion
Plugin de IA: chame conversas de IA diretamente no Obsidian
Plugin de Publicação: sincronize notas para um blog com um clique

Você não precisa instalar plugins desde o início. Primeiro, escreva notas com os recursos nativos, depois procure plugins quando tiver necessidades específicas.

4. Suporte Multiplataforma: Alternância Perfeita Entre Dispositivos

Windows, macOS, Linux, iOS, Android — o Obsidian suporta todos.

E como as notas são apenas pastas comuns, você pode colocá-las em um diretório de sincronização do iCloud ou OneDrive, e todos os dispositivos sincronizarão automática e rapidamente. As notas escritas no computador ficam imediatamente visíveis no celular; a inspiração capturada no celular durante o trajeto está lá quando você abre o computador em casa.

Sem necessidade de pagar pelo serviço de sincronização oficial — basta usar seu serviço de nuvem existente.

5. Completamente Gratuito

Os recursos principais do Obsidian são completamente gratuitos para uso pessoal.

Ele tem dois serviços pagos:

Obsidian Sync (sincronização oficial na nuvem): $4/mês — mas você pode substituí-lo completamente por alternativas gratuitas como iCloud ou OneDrive
Obsidian Publish (publicar como site): $8/mês — mas você pode usar soluções gratuitas como Hugo

Custo real de uso: $0.

Por que o Obsidian Funciona Tão Bem com IA?

Este é o motivo principal para recomendar o Obsidian em um tutorial sobre Obsidian.

Primeiro, a IA pode operar diretamente em suas notas.

Como as notas do Obsidian são arquivos .md locais, ferramentas de IA (como Claude Code) podem ler e editar esses arquivos diretamente. Você pode pedir à IA para ajudar a organizar notas, gerar resumos, modificar formatação em lote e extrair informações-chave das notas.

O Notion não é completamente incapaz — ele pode lidar com isso através do protocolo MCP ou do Notion AI oficial, mas o MCP tem um alto limite de configuração e não é muito conveniente; a IA oficial requer uma taxa adicional. Com os arquivos locais do Obsidian, a IA pode usá-los diretamente com barreira zero.

Segundo, sua biblioteca de notas é a biblioteca de materiais da IA.

As notas de leitura, trechos de artigos e ideias que você acumula diariamente podem ser alimentados à IA como contexto. Quanto mais notas você acumular e melhor organizadas elas estiverem, mais precisos serão os resultados da IA.

Por exemplo, o processo de escrita deste guia envolveu eu dar à IA o material que havia acumulado no Obsidian, e nós o completamos juntos. Sem uma biblioteca de materiais, confiar apenas na IA para escrever do zero resultaria em qualidade muito inferior.

Terceiro, integração sem perdas com Markdown.

A entrada e saída da IA são ambas em Markdown. O Obsidian é nativamente Markdown. Isso significa:

Conteúdo gerado pela IA, quando colado diretamente no Obsidian, se torna notas formatadas
Notas no Obsidian, quando dadas diretamente à IA, são perfeitamente compreendidas
Sem problemas de conversão de formato como com o Word — zero perda

Como Baixar?

Site oficial: obsidian.md Suporta todas as principais plataformas: Windows, macOS, Linux, iOS, Android. Abra o site oficial, clique em “Download”, selecione seu sistema e instale como qualquer outro software.

Abordaremos a configuração e os primeiros passos em detalhes no próximo capítulo.

Resumo

O que você aprendeu hoje:

O que é o Obsidian: um aplicativo de anotações em Markdown com foco em armazenamento local, dados salvos no seu próprio computador
Por que um guia do Obsidian fala sobre IA: a IA precisa de uma biblioteca de materiais local, a produção é a chave para a acumulação de conhecimento
Por que escolher o Obsidian: dados em suas mãos, IA pode operar diretamente, completamente gratuito
Cinco vantagens principais: backlinks, armazenamento local, ecossistema de plugins, multiplataforma, gratuito
Por que funciona bem com IA: arquivos locais que a IA pode ler/escrever diretamente, biblioteca de notas = biblioteca de materiais, Markdown sem perdas
Como baixar: obsidian.md, escolha sua plataforma e instale

Principais conclusões:

Se você puder escolher apenas um aplicativo de anotações, escolha o Obsidian
Dados em suas próprias mãos é o princípio mais importante
Obsidian + IA = seu motor de conhecimento pessoal

Primeiros Passos: Colocando o Obsidian em Uso

Propriedades do Obsidian: Torne Suas Notas Pesquisáveis

Mon, 01 Jan 0001 00:00:00 +0000

Neste capítulo, vamos falar sobre as Propriedades do Obsidian.

No capítulo anterior, cobrimos os plugins, que tornam o Obsidian mais poderoso. Este capítulo aborda algo menos chamativo, mas muito prático: adicionar metadados a cada uma das suas notas.

O Que São Propriedades?

Abra uma nota, clique nos três pontos (⋯) no canto superior direito e selecione “Adicionar propriedade”.

Você verá uma área semelhante a uma tabela no topo da nota: o lado esquerdo é o nome da propriedade, o lado direito é o valor da propriedade. No lado esquerdo, você pode escolher entre as propriedades internas do Obsidian (como tags, aliases) ou criar as suas próprias digitando um nome. No lado direito, preencha o conteúdo correspondente.

É simples assim. Nenhuma codificação necessária.

O Que É Esse YAML?

Se você mudar para o Modo Fonte (Configurações → Editor → Modo de edição padrão → Modo Fonte), verá que as propriedades na verdade se parecem com isto:

---
title: My Note Title
date: 2026-03-03
tags:
  - Obsidian
  - Tutorial
---

O conteúdo entre as duas linhas --- é chamado de frontmatter YAML, um formato de dados. Mas você não precisa escrever isso manualmente — o editor visual do Obsidian cuida de tudo. Clique e selecione no painel de propriedades, e o código subjacente é gerado automaticamente.

Apenas saiba que existe; você não precisa mexer no código fonte no uso diário.

Para Que Servem as Propriedades?

Você pode perguntar: por que não escrever tudo no corpo? Por que adicionar uma camada extra de propriedades?

Três benefícios.

1. Pesquisa Mais Precisa

A pesquisa normal é uma pesquisa de texto completo — se você pesquisar por “tutorial”, todas as notas que contêm a palavra “tutorial” no corpo aparecerão, potencialmente uma lista enorme.

Mas se você definir categories: Tutorial nas propriedades, pode usar a sintaxe de pesquisa do Obsidian para filtrar com precisão:

[categories: Tutorial]

Isso retornará apenas as notas categorizadas como “Tutorial”, e não as notas que mencionam casualmente a palavra “tutorial” no corpo.

Propriedades são dados estruturados; o corpo são dados não estruturados. Quando você tem centenas de notas, essa diferença se torna cada vez mais significativa.

2. Preenchimento Automático de Modelos

Isso funciona em conjunto com modelos. Vamos abordar modelos em detalhes no próximo capítulo, mas aqui vai uma prévia:

Você pode predefinir propriedades em um modelo, como date: {{date}}. Toda vez que você criar uma nova nota a partir desse modelo, a data será preenchida automaticamente com o dia atual. O mesmo vale para propriedades repetitivas como título e categoria — o modelo as preenche para você.

3. Metadados Automáticos de Recortes e Importações da Web

Se você usar um plugin de recorte do navegador (como o Obsidian Web Clipper) para salvar artigos da web no Obsidian, as notas recortadas incluirão automaticamente propriedades — o título original, link, data de salvamento e outras informações são armazenados nas propriedades, ajudando você a rastrear a origem do conteúdo.

Propriedades Comumente Usadas

Você pode criar quaisquer propriedades que desejar, mas algumas são mais usadas. Vale a pena conhecê-las.

1. title

Como o nome sugere, é o título da nota.

Nota: A propriedade title pode ser diferente do nome do arquivo. O nome do arquivo é o que você vê na lista de arquivos; a propriedade title é o “título oficial” da nota.

Por exemplo, tenho um arquivo chamado 2026-03-03 Obsidian-Properties.md, mas a propriedade title é Propriedades do Obsidian: Torne Suas Notas Pesquisáveis — a data no nome do arquivo é para ordenação e não precisa aparecer no título.

Meu conselho pessoal: Se você não tiver necessidades especiais de numeração, defina o título e o nome do arquivo iguais para evitar confusão.

2. date

Registra a data de criação ou publicação da nota.

Se preencher manualmente, o formato é YYYY-MM-DD, por exemplo, 2026-03-03.

Mas aqui vai uma dica: Se você estiver definindo a propriedade date em um modelo, é recomendado escrever:

date: "{{date}}"

Dessa forma, toda vez que você criar uma nova nota a partir do modelo, {{date}} será substituído automaticamente pela data em que você criou a nota. Sem entrada manual, sem erros.

Esse recurso será abordado em detalhes no próximo capítulo sobre modelos.

3. aliases

Esta propriedade é extremamente útil — certifique-se de conhecê-la.

Aliases permitem que você dê vários nomes a uma nota. Muitas vezes nos referimos à mesma coisa por nomes diferentes, e é aí que os aliases entram.

Por exemplo, tenho uma nota sobre Donald Trump com o nome de arquivo “The Donald”. Mas em outras notas, posso me referir a ele como “Trump”, “Donald Trump”, “Presidente Trump” ou “Sr. Trump”.

Sem aliases, se você usar [[Trump]] para criar um link, o Obsidian pensaria que você quer vincular a uma nota chamada “Trump”. Mas essa nota não existe — sua nota se chama “The Donald”. O resultado: você está se referindo à mesma pessoa, mas os links apontam para lugares diferentes.

Com aliases, é diferente. Nas propriedades da nota “The Donald”, escrevo:

aliases:
  - Trump
  - Donald Trump
  - President Trump
  - Mr. Trump

Agora, não importa em qual nota você esteja, quando digitar [[ e depois “Trump”, “Donald Trump” ou “Sr. Trump”, o Obsidian sugerirá vincular à nota “The Donald”. Vários nomes, uma entrada.

Isso é especialmente útil ao construir uma base de conhecimento. Muitos conceitos têm nomes alternativos, abreviações ou nomes em inglês. Usar aliases para gerenciá-los mantém seus links organizados.

4. categories

Marque notas com uma categoria ampla, como “Notas de Livros”, “Tutorial”, “Pensamentos Aleatórios”, etc.

categories:
  - Obsidian Tutorial

Categorias são principalmente para sua própria referência, ajudando você a filtrar rapidamente notas do mesmo tipo. Se você publicar suas notas em um blog posteriormente, muitos sistemas de blog (como Hugo, Hexo) lerão essa propriedade para gerar páginas de categoria.

5. tags

Tags são familiares para a maioria. No Obsidian, você pode adicionar tags no corpo usando #nomedatag, ou escrevê-las uniformemente nas propriedades:

tags:
  - Obsidian
  - Tutorial
  - Note-taking

A vantagem de escrever tags nas propriedades é o gerenciamento centralizado — você pode ver rapidamente quais tags uma nota possui, sem precisar procurar no corpo.

Mas, para ser honesto, no Obsidian, o papel das tags pode ser amplamente substituído por links. Se você acha que um conceito é importante o suficiente para ser marcado, por que não criar uma nota para ele e vinculá-lo? Links são mais flexíveis e podem conter mais conteúdo.

Claro, se você está acostumado com tags, tudo bem. Tags e links não entram em conflito — escolha o que funciona para você.

6. Outras Propriedades Úteis

Além das cinco acima, aqui estão mais algumas que você pode achar úteis:

cssclasses — Atribui estilos CSS especiais a uma única nota. Por exemplo, se você quiser que uma nota use uma fonte ou layout diferente, pode usar esta propriedade com CSS personalizado. Recurso avançado; iniciantes podem pular por enquanto.

publish — Se você usar o serviço de publicação oficial do Obsidian (Obsidian Publish), esta propriedade controla se a nota é publicada. true para publicar, false para não publicar.

description — Uma breve descrição ou resumo da nota. Quando usado com um sistema de blog, esta propriedade geralmente aparece como texto de pré-visualização nas listas de artigos.

Você também pode criar quaisquer propriedades que precisar — como author, source, status (rascunho/concluído), etc. As propriedades são totalmente personalizáveis; adicione o que achar útil.

Resumo

O que aprendemos hoje:

O que são propriedades: Informações estruturadas no topo de uma nota. Adicione-as clicando nos três pontos — sem necessidade de codificação.
Por que usá-las: Pesquisa precisa, preenchimento automático de modelos, metadados automáticos de recortes da web.
Propriedades comumente usadas:
- title — Pode ser diferente do nome do arquivo.
- date — Use {{date}} em modelos para preenchimento automático.
- aliases — Vários nomes apontando para a mesma nota, essencial para vinculação.
- categories — Agrupe notas em categorias amplas.
- tags — Gerenciamento centralizado, mas links podem substituir a maioria dos casos de uso.
Propriedades são totalmente personalizáveis: Adicione o que precisar.

Principais conclusões:

Aliases são a propriedade mais valiosa — um ótimo complemento para o sistema de vinculação.
Tags funcionam, mas no Obsidian, links são mais poderosos.
Não defina muitas propriedades no início; adicione conforme necessário.

Publicar do Obsidian para o WeChat: Como Construí o Plugin

Mon, 01 Jan 0001 00:00:00 +0000

📌 Nota do Editor: Este capítulo foi originalmente escrito quando o WeChat Publisher ainda tinha versões gratuita e paga. Desde a v0.1.13, o WeChat Publisher é completamente gratuito para usuários pessoais—todos os recursos (visualização de formatação, copiar HTML, publicar rascunhos, múltiplas contas, sistema de capa, etc.) são desbloqueados diretamente, sem necessidade de código de ativação. Este capítulo foi atualizado para remover referências a código de ativação/pagamento; algumas capturas de tela no texto original ainda mostram o botão “Comprar Ativação”, mas essa entrada foi removida na nova versão—ignore-a.

Os capítulos anteriores cobriram as ferramentas que você pode usar no Obsidian para gerenciamento e operações. Este capítulo final muda o foco—publicar o que você escreveu no Obsidian para o WeChat.

Você escreveu seu artigo. Agora, como publicá-lo no WeChat?

Essa etapa trava muita gente. Não é que não saibam escrever—é que depois de escrever, não conseguem publicar, ou a formatação fica completamente bagunçada.

Este capítulo aborda esse problema e apresenta um plugin que eu mesmo construí: WeChat Publisher.

Para ser honesto, levei vários dias, trabalhando de forma intermitente, para construir este plugin. Achei que não seria complicado, mas quando comecei, encontrei muito mais armadilhas do que esperava—várias limitações da API do WeChat, conversão de formato de imagem, problemas de compatibilidade com estilos inline de HTML—enfrentei uma por uma. Felizmente, o resultado final é muito bom e, depois de usar por um tempo, realmente economiza muito trabalho.

Eu nunca imaginei que publicar um plugin publicamente pudesse ser tão trabalhoso!

Qual é a Dificuldade de Escrever para o WeChat no Obsidian?

Vamos começar com um cenário que muita gente já enfrentou.

Você escreve um artigo no Obsidian. Ele tem blocos de código, títulos em negrito, tabelas—fica ótimo no Obsidian. Então você copia o conteúdo e cola no editor do WeChat Official Account—tudo vira uma bagunça. Blocos de código viram texto simples, a hierarquia dos títulos se perde e as imagens precisam ser enviadas uma a uma manualmente.

É como formatar um documento bonito no Word, só para o destinatário abri-lo e ver texto ilegível.

Geralmente existem dois caminhos:

Caminho 1: Escrever diretamente no editor do WeChat. Sem problemas de formatação, mas o editor não suporta Markdown, o que torna a escrita dolorosa.

Caminho 2: Escrever no Obsidian, copiar e colar no editor e depois corrigir a formatação manualmente. A formatação acerta, mas cada artigo leva de 20 a 30 minutos só para essa etapa.

Existe uma maneira melhor? Sim.

O que é o WeChat Publisher?

Resumindo: Escreva no Obsidian, visualize a formatação do WeChat diretamente e publique no seu rascunho do WeChat com um clique.

O que ele faz por você: Renderiza Markdown em HTML compatível com WeChat, envia imagens locais para o CDN do WeChat, converte diagramas Mermaid e fórmulas matemáticas em imagens e envia o artigo inteiro para o rascunho. Você só precisa fazer o passo final no backend do WeChat: enviar o artigo.

Veja os resultados.

Bloco de código (destaque de sintaxe):

Fórmulas matemáticas e diagramas Mermaid:

Anotações Ruby e imagens com rolagem horizontal:

Todos esses foram enviados diretamente do Obsidian, sem nenhum ajuste manual de formatação.

Principais Recursos de Relance

Recurso	Descrição
🎨 Visualização de Formatação	Renderização Markdown em tempo real no estilo WeChat, WYSIWYG
📋 Copiar HTML	Copiar HTML renderizado com um clique, colar no editor do WeChat
🚀 Publicar com Um Clique	Enviar diretamente para o rascunho do WeChat, sem precisar do navegador
🖼 Sistema de Capa	Definir capa automaticamente a partir de imagens do artigo, suporta capas personalizadas
👥 Múltiplas Contas	Gerenciar várias contas do WeChat a partir de um único plugin
🎨 Alternância de Temas	8 temas integrados, estilos personalizáveis

Completamente gratuito para usuários pessoais. Para uso comercial (empresas, instituições de treinamento, redistribuição, etc.), entre em contato com o autor através da conta WeChat ‘HelloRanceLee’ para autorização.

Como Instalar

O plugin ainda não está no mercado oficial de plugins do Obsidian. Existem dois métodos de instalação.

Método 1: Instalar via BRAT (Recomendado)

BRAT é uma ferramenta de gerenciamento de plugins na comunidade Obsidian, específica para instalar plugins que ainda não estão no mercado, e gerencia atualizações automaticamente.

Passo 1: Instalar o BRAT.

No Obsidian, vá em ‘Configurações’ → ‘Plugins da comunidade’ → ‘Procurar’, pesquise por BRAT, instale e ative.

Passo 2: Adicionar o WeChat Publisher.

Abra ‘Configurações’ → ‘BRAT’, clique em Adicionar plugin beta e insira a URL do repositório:

RanceLee233/wechat-publisher

Clique em Adicionar Plugin, selecione a versão mais recente, e o BRAT fará o download automaticamente.

Passo 3: Ativar o plugin.

Volte para ‘Configurações’ → ‘Plugins da comunidade’, encontre o WeChat Publisher e ative-o.

Quando novas versões forem lançadas, o BRAT as detectará automaticamente, ou você pode clicar manualmente em Verificar atualizações.

Método 2: Instalação Manual

Se o acesso ao GitHub for inconveniente, você pode baixar o zip diretamente do meu blog:

https://blog.discoverlabs.ac.cn/downloads/wechat-publisher/

Após descompactar, coloque a pasta no diretório de plugins do Obsidian:

your-vault-path/.obsidian/plugins/wechat-publisher/

A estrutura do diretório deve ficar assim:

.obsidian/
  plugins/
    wechat-publisher/
      main.js
      manifest.json
      styles.css

Em seguida, ative-o também em ‘Plugins da comunidade’.

Abrindo o Plugin

Após a instalação, um ícone do WeChat Publisher aparecerá na barra lateral esquerda do Obsidian. Clique nele para abrir. Você também pode pressionar Cmd+P (Windows: Ctrl+P) e pesquisar por WeChat Publisher.

A barra de ferramentas superior, da esquerda para a direita: Formatação · Nome da Conta · Configuração da Conta · Guia do Usuário · Atualizar Renderização · Copiar HTML · Ir para Colar no WeChat · Publicar Rascunho.

Abaixo da barra de ferramentas está a área de informações de publicação (título, autor, capa), e mais abaixo está a área de visualização do artigo.

Capturas de tela de versões mais antigas podem ainda mostrar o botão ‘Comprar Ativação’, mas ele foi removido na nova versão—todos os recursos estão disponíveis diretamente.

Uso 1: Copiar HTML e Colar (Sem Necessidade de Configuração de API)

O uso mais simples, sem necessidade de configurar conta—escreva e publique diretamente.

Passo 1: Ajustar a formatação (opcional).

Clique no botão Formatação no topo para expandir a barra de controle de estilo. Você pode alternar entre temas integrados ou ir em Configuração de Estilo para ajustar tamanho da fonte, espaçamento entre linhas, cores e outros detalhes.

É recomendável configurar um estilo que você goste na primeira vez e salvá-lo. Para artigos futuros, você pode aplicar diretamente o ‘Estilo Salvo’ sem reconfigurar cada vez.

Passo 2: Clique em ‘Copiar HTML’.

O plugin copia o HTML renderizado para sua área de transferência com formatação completa.

Passo 3: Clique em ‘Ir para Colar no WeChat’.

Seu navegador abre automaticamente o backend do WeChat, e você pode colar no editor.

Todo o processo leva cerca de dez segundos, muito mais rápido do que a formatação manual.

Uso 2: Publicar com Um Clique no Rascunho

Se você publica artigos com frequência, pode configurar a API do WeChat para que o plugin envie artigos diretamente para o rascunho, sem nunca abrir um navegador.

Passo 1: Configurar Sua Conta do WeChat

Clique em Configuração da Conta no topo para abrir o pop-up de configuração. O topo do pop-up lista todas as contas adicionadas como abas; clique para alternar.

Campos a preencher:

Campo	Descrição
Nome da Conta	Qualquer nome que você escolher, para distinguir várias contas
AppID	O AppID da sua conta WeChat, obtido na Plataforma de Desenvolvedor WeChat
AppSecret	Chave secreta do desenvolvedor, deve ser ativada manualmente na plataforma
Autor Padrão	Opcional, preenchido automaticamente ao publicar
Capa Padrão	Opcional, define uma capa fixa para esta conta

Na parte inferior, há dois botões: Adicionar Conta Manualmente (preencher o formulário) e Colar Rápido Nova Conta (reconhecimento automático com um clique a partir de conteúdo copiado da plataforma WeChat). Após preencher, clique em Salvar.

Colar Rápido Nova Conta

Não quer preencher formulários? Há uma maneira mais rápida: Abra a página ‘Informações Básicas’ na plataforma WeChat Official Account, selecione tudo e copie o conteúdo. Em seguida, no pop-up de configuração de conta do WeChat Publisher, clique em ‘Colar Rápido Nova Conta’, cole o conteúdo, e o plugin reconhece automaticamente o nome da conta, AppID e AppSecret—adição com um clique.

O formato do conteúdo colado é mais ou menos o seguinte, e o plugin o analisa automaticamente:

Official Account
Your WeChat Account Name
AppID
wxb3f8a2e9c7d10456
AppSecret
e4a27f3c1b9d8056f2e8a3c7b4d90561

Como Obter AppID e AppSecret

Passo 1: Abra developers.weixin.qq.com e clique em ‘Ir para o Console’.

Passo 2: Em ‘Meus Negócios’, encontre sua conta WeChat e clique nela.

Passo 3: Entre no backend de gerenciamento da conta WeChat, encontre o AppID na página ‘Informações Básicas’ (copie diretamente), depois clique em Ativar ao lado de AppSecret, escaneie o código QR para autorizar e você poderá obtê-lo.

O AppSecret é exibido completo apenas uma vez no momento da ativação. Copie e salve imediatamente; caso contrário, você terá que regenerá-lo.

Configurar Lista de IPs Permitidos

A API do WeChat exige que o endereço IP da máquina que chama a interface esteja em uma lista de permissões. O WeChat Publisher chama a API diretamente do seu computador, então você precisa adicionar seu IP público à lista de permissões.

O plugin tem um recurso auxiliar: No pop-up de configuração da conta, clique em ‘Detectar IP Local’ para obter automaticamente seu IP público, clique em ‘Copiar’, depois vá para a ‘Lista de IPs Permitidos da API’ na plataforma WeChat e cole para salvar.

Se você usa tanto em casa quanto no trabalho, os IPs públicos das duas redes são diferentes, então adicione ambos.

Passo 2: Publicar Rascunho com Um Clique

Abra a nota que deseja publicar, preencha o título e o autor na área de informações de publicação, defina a capa conforme necessário e clique em Publicar Rascunho no topo.

O plugin automaticamente:

Envia imagens locais no artigo para o CDN do WeChat
Renderiza diagramas Mermaid e fórmulas matemáticas em imagens
Submete o HTML renderizado junto com título, autor e capa para o rascunho

Após a conclusão, vá para o rascunho no backend do WeChat, verifique e, se estiver tudo certo, envie.

O rascunho não é enviado diretamente; você precisa enviá-lo manualmente pelo backend.

Republicar atualiza automaticamente, sem artigos duplicados: Se esta nota já foi publicada como rascunho anteriormente, após fazer alterações e clicar em ‘Publicar Rascunho’ novamente, o plugin encontrará automaticamente o rascunho existente na plataforma WeChat e o atualizará, sem criar um novo artigo duplicado.

Como Definir a Capa

A área de informações de publicação tem três botões de capa:

Botão	Descrição
Selecionar Capa do Computador	Escolher manualmente uma imagem do seu computador a cada vez
Capa Padrão	Usar a capa predefinida na configuração da conta
Limpar Capa	Sem capa, usa uma imagem em branco de espaço reservado ao publicar

Prioridade da capa: Seleção manual > Capa padrão da conta > Imagem de espaço reservado.

É recomendável definir uma capa padrão na configuração da conta para não precisar selecionar manualmente a cada publicação.

Formatos Suportados

Formato	Suporte
Blocos de código	✅ Destaque de sintaxe, preserva indentação e espaços
Fórmulas matemáticas	✅ Fórmulas inline e em bloco, renderizadas como imagens
Diagramas Mermaid	✅ Fluxogramas, diagramas de sequência, etc., renderizados como imagens
Tabelas	✅ Restauração completa do estilo
Imagens locais	✅ Envio automático para o CDN do WeChat ao publicar (suporta caminhos relativos `../`)
Imagens remotas	✅ Processadas automaticamente
Anotações Ruby	✅ Múltiplos formatos de sintaxe
Blocos de alerta	✅ `> [!NOTE]` / `[!WARNING]` etc.
Imagens com rolagem horizontal	✅ Múltiplas imagens exibidas lado a lado
#Tags	✅ Renderizadas como estilo cápsula
Callout do Obsidian	✅
Negrito, itálico, tachado, destaque	✅

Quanto mais complexo seu artigo, mais tempo você economiza. Se seu artigo contém blocos de código, fórmulas matemáticas ou diagramas Mermaid, o tempo gasto para lidar com eles manualmente é significativo.

Resumo

O que você aprendeu hoje:

O maior problema de escrever para o WeChat no Obsidian é a conversão de formatação—o WeChat Publisher resolve isso
Dois métodos de uso: Copiar HTML e colar no backend do WeChat (sem configuração, 10 segundos); ou configurar a API para publicar com um clique no rascunho (ainda mais conveniente)
Configurar a API requer AppID + AppSecret + lista de IPs permitidos, uma configuração única
Suporta formatos complexos como destaque de bloco de código, Mermaid, fórmulas matemáticas, envio automático de imagens locais, etc.
Completamente gratuito para usuários pessoais desde a v0.1.13, todos os recursos desbloqueados diretamente, sem necessidade de código de ativação

Pontos-chave:

Completamente gratuito para usuários pessoais, fique à vontade para baixar e usar
Para uso comercial (empresas, treinamento, redistribuição), entre em contato com o autor através da conta WeChat ‘HelloRanceLee’
Configurar a API do WeChat é uma tarefa única, não é difícil se você seguir o tutorial
Lembre-se de configurar a lista de IPs permitidos antes de publicar, caso contrário as chamadas de API darão erro
É recomendável configurar e salvar seu estilo na primeira vez, depois aplicá-lo diretamente para cada artigo

Obtenha a versão mais recente do plugin:

GitHub: https://github.com/RanceLee233/wechat-publisher
Download direto: https://blog.discoverlabs.ac.cn/downloads/wechat-publisher/

Parte 5: Colaboração com IA: Transforme o Obsidian em uma Bancada de Trabalho de IA

Recorte Vídeos do YouTube no Obsidian

Mon, 01 Jan 0001 00:00:00 +0000

Lembra do Web Clipper do capítulo anterior? É a extensão oficial do Obsidian para navegadores que permite salvar artigos da web como arquivos Markdown locais e limpos com um clique, rápido e sem depender de serviços de terceiros.

Infelizmente, antes ele só recortava texto. Mas recentemente, ele foi atualizado silenciosamente para a versão 1.4, adicionando um novo recurso que fez meus olhos brilharem:

Agora ele suporta recorte de vídeos do YouTube.

Não é uma operação meia-boca como tirar uma captura de tela ou salvar um link. Em vez disso, ele extrai a transcrição completa do vídeo com carimbos de tempo. Você pode clicar em qualquer linha de legenda para pular para aquele ponto no vídeo e, conforme o vídeo é reproduzido, as legendas rolam automaticamente.

Esse recurso resolveu um problema antigo para mim — quando quero fazer anotações enquanto assisto a um vídeo, não preciso mais ficar pausando para digitar manualmente as legendas.

Primeiro, uma rápida atualização sobre o Web Clipper

Se esta é a primeira vez que você ouve falar deste plugin, aqui vai um breve contexto.

O Web Clipper é a extensão oficial do Obsidian para navegadores, compatível com Chrome, Edge, Firefox e outros navegadores principais. Sua função principal é salvar conteúdo da web como arquivos Markdown locais com um clique — formatação limpa, totalmente offline e sem envolver serviços de nuvem de terceiros.

A instalação e a configuração básica foram abordadas no capítulo anterior, então não vou repeti-las aqui.

Neste post, vamos direto para a nova funcionalidade. Mas antes, um aviso: você precisa atualizar o plugin para a versão 1.4 ou superior.

Entrando no Modo de Recorte do YouTube

O processo é simples.

Abra qualquer vídeo do YouTube, clique no ícone do Web Clipper na barra de ferramentas do seu navegador e, quando o painel do plugin aparecer, procure pelo ícone de “livro aberto” e clique nele.

Após clicar, a interface se transforma completamente.

Você verá o vídeo no topo e a transcrição completa abaixo, com cada linha com carimbo de tempo.

Essa interface não é estática. Conforme o vídeo é reproduzido, as legendas rolam automaticamente para acompanhar, e a linha atual é destacada. Funciona nos dois sentidos — clique em qualquer linha de legenda e o vídeo pula para aquele ponto.

O que essa interface oferece

A descrição oficial dessa interface de legendas do YouTube é:

Fornece funcionalidade interativa de legendas, suportando fixação de vídeo, reprodução por salto via legendas, rolagem automática e destaque da posição atual.

Em termos simples, ela faz quatro coisas:

Fixação do Vídeo: Quando você rola pelas legendas, o vídeo permanece fixo no topo. Você pode navegar pela transcrição enquanto o vídeo continua tocando, sem interferência.

Clique para Pular: Encontre uma frase de seu interesse, clique nela e o vídeo pula para lá imediatamente. Chega de arrastar manualmente a barra de progresso para adivinhar o tempo.

Rolagem Automática: A área de legendas rola em tempo real com a reprodução do vídeo, para que você não precise acompanhar manualmente.

Destacar Posição Atual: A linha de legenda atualmente em reprodução é destacada, para que você veja rapidamente onde está no vídeo.

Há também alguns recursos extras no canto superior direito: você pode sublinhar legendas, destacar texto e ajustar o tamanho da fonte.

Se você achar que o vídeo vale a pena ser arquivado, clique no ícone do Obsidian no canto superior direito, e todo o conteúdo será salvo localmente como um recorte normal.

Após Salvar no Obsidian

Após salvar, abra o Obsidian e encontre a nova nota.

No topo, você verá uma prévia incorporada do vídeo original que pode ser reproduzida diretamente no Obsidian; abaixo dela está a transcrição completa com carimbos de tempo.

No futuro, quando quiser revisitar este vídeo, não precisa abrir o navegador e procurar por ele. Tudo está no Obsidian — pesquisa, referência, anotação, tudo em um só lugar.

E se você não entende inglês?

Muitos vídeos excelentes no YouTube estão em inglês, com legendas em inglês. Mas há uma solução. Já cobrimos três métodos antes, e vou reiterá-los aqui:

Immersive Translate: Esta extensão de navegador pode fornecer diretamente traduções bilíngues para legendas do YouTube, exibindo chinês e inglês lado a lado. É a mais simples de usar.

Conectar o DeepSeek no Web Clipper: O Web Clipper suporta configurar uma interface de IA. Você pode configurá-lo para chamar automaticamente o DeepSeek para traduzir o conteúdo para chinês durante o recorte. Configure uma vez e fica totalmente automático a partir de então. Isso significa que as legendas abaixo do vídeo já estarão traduzidas quando chegarem ao seu cofre.

Traduzir com o Claudian após salvar: Após salvar as legendas do vídeo no Obsidian, use a barra lateral do Claudian para traduzi-las. Os resultados são excelentes, e você pode até fazer com que crie uma versão bilíngue, uma versão apenas em chinês, etc.

Esses três métodos foram abordados em artigos anteriores. Se tiver dúvidas, sinta-se à vontade para consultá-los.

Infelizmente, o Bilibili não é suportado

É uma pena que esse recurso atualmente não suporta o Bilibili, especialmente porque o Bilibili é minha plataforma preferida para vídeos educacionais. Espero que a equipe oficial adicione suporte no futuro.

Felizmente, criei anteriormente uma habilidade gratuita e de código aberto que pode lidar com conteúdo de vídeo do Bilibili. Você pode encontrá-la na página de download do blog. Se precisar, vá conferir.

O que aprendemos hoje

O Web Clipper 1.4 adicionou recorte de vídeos do YouTube. Para entrar nesse modo, clique no ícone de “livro aberto” no painel do plugin.
A interface de legendas suporta quatro recursos: fixação de vídeo, reprodução por clique para pular, rolagem automática e destaque da posição atual.
Após salvar, a nota do Obsidian inclui tanto uma prévia incorporada do vídeo original quanto a transcrição completa com carimbos de tempo.
Vídeos em inglês não são uma barreira. Immersive Translate, conectar o DeepSeek no Web Clipper e o Claudian são três soluções viáveis.
O Bilibili não é suportado atualmente, mas há uma habilidade gratuita de código aberto para preencher a lacuna.

Principais conclusões

O recorte de YouTube do Web Clipper não se trata de tirar capturas de tela ou salvar links; ele extrai a transcrição completa e a linha do tempo.
Legendas e vídeo estão vinculados bidirecionalmente: clique em uma legenda para pular no vídeo, e as legendas acompanham a reprodução do vídeo.
Uma vez salvo no Obsidian, o conteúdo do vídeo se torna uma nota local pesquisável e citável.
Três métodos de tradução estão disponíveis para atender às suas necessidades; o idioma não é uma barreira.
O Bilibili ainda não é suportado — esteja ciente dessa limitação.

Temas do Obsidian: Mude a Aparência em Cinco Minutos

Mon, 01 Jan 0001 00:00:00 +0000

Já cobrimos o Excalidraw para desenho, fluxogramas e mapas mentais — bastante conteúdo prático. Este capítulo é algo mais leve: mudar temas para deixar o Obsidian com uma ótima aparência.

Os últimos capítulos foram densos, então considere isso uma pausa. As configurações de tema são simples, mas merecem um capítulo próprio porque uma interface bonita realmente faz você querer abrir o aplicativo e escrever mais.

Este capítulo cobre três coisas:

Instalar temas pelo mercado integrado do Obsidian
Instalar temas manualmente pelo GitHub (avançado, raramente necessário)
Minha recomendação pessoal: o tema Nord

O que é um tema e por que mudá-lo?

A interface padrão do Obsidian… como dizer, simples. É funcional, mas visualmente tem aquela sensação de “funciona” sem muito apelo.

Depois de trocar de tema, a experiência é completamente diferente. Alguns temas são minimalistas e limpos, alguns têm alta densidade de informação para organizar muitas anotações, alguns são escuros e agradáveis aos olhos para longas sessões. Esquemas de cores, estilos de fonte, layouts da barra lateral — tudo muda.

Temas não são só sobre “parecer bonito”. Naquele momento em que você abre o aplicativo todos os dias — se a interface parecer agradável, a resistência subconsciente diminui significativamente. Quando se trata de manter o hábito de anotar, a “sensação” e a “estética” da ferramenta realmente importam.

Então, gastar meia hora escolhendo um tema que você gosta vale muito a pena.

Instalando temas pelo mercado integrado

Esta é a maneira mais direta. O mercado tem centenas de temas da comunidade, todos gratuitos, instalação com um clique.

Caminho: Configurações → Aparência → Temas → Navegar

Ao entrar, você verá uma lista. Pode ordenar por downloads ou pesquisar por um nome de tema específico. Encontre um que goste, clique nele, clique em “Instalar e usar”, e o tema é trocado. É simples assim — sem etapas extras.

Resumo das etapas:

Abra Configurações
Clique em “Aparência” à esquerda
Encontre a seção “Temas”, clique em “Navegar”
Pesquise ou navegue para encontrar um tema que goste
Clique em “Instalar e usar”

Se quiser voltar ao tema padrão, faça o mesmo aqui e mude o tema para “Padrão”.

Instalando temas manualmente pelo GitHub

Este método é desnecessário para a maioria das pessoas, mas vou abordá-lo brevemente caso você encontre um tema que está apenas no GitHub e não no mercado.

Etapas da instalação manual:

Acesse o repositório correspondente no GitHub e baixe os arquivos do tema (geralmente uma pasta contendo theme.css e manifest.json)
Coloque a pasta inteira no diretório .obsidian/themes/ do seu cofre
Reinicie o Obsidian
Depois vá em Configurações → Aparência → Temas, e você verá o tema recém-instalado

Nota: A pasta .obsidian fica oculta por padrão. No Mac, pressione Command + Shift + . para mostrar arquivos ocultos.

Novamente: A maioria das pessoas nunca precisará deste método. O mercado integrado já tem centenas de temas, mais que suficientes para o uso diário. Apenas saiba que este método existe.

Minha escolha: o tema Nord

Agora que cobrimos os métodos, deixe-me compartilhar minha escolha pessoal — Obsidian Nord. É o tema que uso há mais tempo, e quase não troquei desde que o instalei.

A paleta de cores do Nord vem do “sistema de cores Nord”, inspirado nas auroras nórdicas e no gelo e neve polares. É um esquema de azul profundo com tons frios. Não é chamativo ou estridente, mas um conjunto de cores muito estável e duradouro.

Por que escolhi ele:

Escuro e agradável aos olhos: Confortável para longas sessões — não é um preto puro agressivo, mas uma cor profunda com tons azul-acinzentados
Esquema de cores suave: Cores de destaque, cores de links e cores de cabeçalhos são todas contidas, mantendo a interface sem poluição visual
Apelo atemporal: Uso há dois anos, e toda vez que abro o Obsidian ainda parece agradável — sem vontade de trocar

Instalação: Basta pesquisar por “Obsidian Nord” no mercado de temas, depois instalar e ativar.

Resumo

O que você aprendeu hoje:

Ponto de entrada para mudar temas: Configurações → Aparência → Temas → Navegar
O mercado integrado tem centenas de temas gratuitos — encontre um que goste e instale/ative diretamente
O modo escuro/claro pode ser alternado em Configurações → Aparência → Esquema de cores base
Para o raro tema que não está no mercado, você pode baixar manualmente do GitHub e colocar na pasta .obsidian/themes/
Tema recomendado: Obsidian Nord

Principais conclusões:

Para uso diário, o mercado integrado é suficiente — simples e conveniente
Uma interface bonita reduz a resistência mental para abrir suas anotações todos os dias — vale a pena escolher com cuidado
Nord é o tema que uso há dois anos, ótimo para quem prefere tons escuros e frios

Transforme uma Wiki no Estilo Karpathy em uma Habilidade Reutilizável

Mon, 01 Jan 0001 00:00:00 +0000

Os últimos dias têm sido uma verdadeira luta para fazer essa habilidade funcionar.

Comecei com o Opus 4.6. Gastei mais de 20 dólares. Ainda assim não consegui fazê-la funcionar. Cheguei a me perguntar se o novo modelo lançado na manhã de 8 de abril de 2026 tinha sugado todo o poder de computação deles. Caso contrário, como poderia entender uma coisa e depois sair do rumo na sequência?

Depois mudei para o Codex, e consegui construí-la.

Mas um novo problema surgiu: construí-la não significa que ela funciona de forma confiável.

Especialmente quando você começa a testá-la a sério, ela ocasionalmente ignorava instruções e fazia alterações por conta própria, o que me deixava louco.

Então, neste artigo, não quero apenas dizer “construí uma habilidade, fique à vontade para baixá-la”.

Quero deixar outra coisa clara: como implementar de fato o método LLM Wiki que o Karpathy propôs em um vault do Obsidian.

O capítulo anterior cobriu o método. Este capítulo é sobre a prática.

Se você quiser baixar a versão atual sanitizada da minha habilidade, aqui está o link:

https://blog.discoverlabs.ac.cn/downloads/obsidian-wiki-skill/

Já removi as chaves de API, caminhos locais, etc. Mas vou dizer isso de antemão: não copie na íntegra.

Você pode aprender com este método. Você também pode modificar esta habilidade. Mas não espere que ela funcione imediatamente. O vault de notas de cada pessoa é muito diferente.

O que construí não é “IA organizando minhas notas”, mas “IA fazendo minha contabilidade”

Vamos primeiro revisitar a Gist do Karpathy.

Link original:

https://gist.github.com/karpathy/442a6bf555914893e9891c11519de94f

A ideia central é na verdade simples:

A maioria das pessoas atualmente usa LLMs para processamento de documentos via RAG: despeja um monte de arquivos e, ao consultar, recupera e gera respostas na hora.

Isso funciona, claro.

Mas o problema é que é tudo ad hoc.

Pergunta uma vez, monta uma vez. Pergunta de novo, começa do zero. Sem acúmulo.

Então ele propôs uma camada intermediária: em vez de montar respostas na hora para cada consulta, manter continuamente uma Wiki.

Quando li isso, minha primeira reação não foi “isso é legal”.

Foi: não é exatamente o tipo de tarefa para a qual o Obsidian é mais adequado?

Porque o Obsidian é inerentemente um vault de arquivos Markdown locais.

A Wiki que Karpathy descreve é essencialmente uma coleção de arquivos Markdown.

O formato subjacente é quase idêntico.

A diferença é:

Antes, você mantinha manualmente backlinks, páginas de tópicos e páginas de estrutura
Agora a IA ajuda você com esse trabalho de “contabilidade”

Nota: contabilidade, não pensamento.

Cada vez mais concordo com isso.

Ler artigos, fazer julgamentos, escrever suas próprias opiniões — isso ainda é para você fazer.

Mas tarefas como completar backlinks, normalizar nomes de autores, verificar formatação e atualizar páginas derivadas são essencialmente trabalho braçal. A IA pode lidar com elas.

Como implementei a estrutura de três camadas do Karpathy no Obsidian

A parte mais importante do método do Karpathy são as três camadas:

Raw Sources (Fontes Brutas)
The Wiki (A Wiki)
The Schema (O Esquema)

Minha habilidade obsidian-wiki também é construída em torno dessas três camadas.

Primeira Camada: Raw Sources

No meu vault, esta camada consiste em:

01-Notes/
04-Output/

Ou seja, coleções brutas, notas brutas e artigos que escrevi.

Mantenho esta camada muito contida.

Sua única responsabilidade é preservar o conteúdo original.

Não deixo que ela assuma funções extras.

Não misturo conteúdo derivado.

Não deixo um artigo bruto se tornar metade página de tópico, metade página de índice.

Porque uma vez misturado, fica difícil de manter.

Esta é uma das lições mais profundas que aprendi ao construir esta habilidade: quanto mais limpa a camada bruta, mais fácil tudo o resto se torna.

Segunda Camada: The Wiki

Esta camada é separada no meu vault:

01-Notes/wiki/

Aqui reside a camada estrutural derivada pela IA, como:

Páginas de autores
Páginas de tópicos
Índice
Log
Diretório de backlinks

Em outras palavras, o texto original permanece o texto original.

A Wiki é a Wiki.

As duas camadas são separadas.

Isso parece trivial, mas na verdade é muito importante.

Porque se você não separar as camadas, toda vez que a IA organiza, ela tende a deixar o texto original mais bagunçado.

Hoje adiciona um bloco de tópico.

Amanhã insere um índice.

Depois de amanhã, adiciona um resumo gerado automaticamente.

Eventualmente, todo o vault parece um quarto que está sendo constantemente arrumado, mas fica mais bagunçado.

Terceira Camada: The Schema

Muitas pessoas ignoram esta camada.

Karpathy menciona schema em seu post original. Meu entendimento é: você precisa dizer à IA como o vault deve ser.

No meu caso, isso inclui:

SKILL.md
Um monte de scripts/
Convenções de frontmatter
Restrições sobre como autores e tópicos são escritos
Restrições de processo para lint e ingest

Por exemplo, agora eu imponho:

Autores devem estar no formato de backlink
Tópicos devem ser uma lista de backlinks
Páginas de autores e páginas de tópicos só podem ir em 01-Notes/wiki/
00-Inbox/ é apenas uma caixa de entrada de processamento, não misturada diretamente na Wiki
Artigos brutos não contêm mais parágrafos derivados

Você descobrirá que o que faz a habilidade funcionar não é o quão bonito o prompt é escrito. A chave real é que essas restrições são estabelecidas primeiro.

Traduzindo as Três Ações em Fluxos de Trabalho Executáveis

Karpathy também tem três ações principais:

Ingest
Query
Lint

Eu segui a mesma abordagem.

Em termos do fluxo de trabalho real nesta habilidade, fica assim:

Ingest: wiki_lint.py --preflight + ob_shuanglian.py suggest/apply + wiki_ingest.py
Query: Primeiro ler wiki/index.md, authors/*.md, topics/*.md, depois voltar ao texto original para detalhes
Lint: wiki_lint.py, wiki_migrate.py, wiki_build_skeleton.py

Ingest: Verificar novo conteúdo antes de adicioná-lo ao vault

Não deixo a IA “ver um artigo e improvisar” imediatamente.

Meu fluxo de trabalho atual começa com uma verificação prévia (preflight).

Primeiro verifica se o frontmatter está correto.

Depois verifica contaminação histórica.

Então faz sugestões de backlinks.

Após confirmação do usuário, aplica de fato.

Finalmente, atualiza a camada derivada da Wiki.

Por que toda essa complicação?

Porque os modelos me ensinaram muitas vezes.

Se você não adicionar essas salvaguardas, eles vão ansiosamente “tomar decisões” por você.

O problema é que as decisões deles podem não ser o que você quer.

Então adicionei fortes portões de confirmação.

Não deixe que escrevam tópicos arbitrariamente.

Não deixe que apliquem backlinks diretamente.

Não deixe que decidam sobre aliases de autores por conta própria.

Dê sugestões, eu confirmo, depois escrevem.

Isso pode parecer menos eficiente.

Mas com uma base de conhecimento, o maior medo não é a lentidão; é escrever algo errado silenciosamente.

Query: Não pescar no mar de texto original, mas ler a camada Wiki primeiro

Para consultas, minha abordagem não é “pesquisar todo o vault e entregar à IA para resumir”.

Em vez disso, primeiro passa por:

wiki/index.md
authors/*.md
topics/*.md

Deixe a IA olhar para a camada estruturada primeiro.

Quando necessário, volte a artigos específicos para detalhes.

Os benefícios são claros:

Ela não precisa remontar a partir de textos originais dispersos toda vez.

Em vez disso, responde a partir de uma camada já organizada.

Isso está mais próximo do que Karpathy quer dizer com “acúmulo”.

Lint: A etapa mais importante e mais subestimada

Muitas pessoas focam em Query quando veem LLM Wiki.

Mas quanto mais trabalho nisso, mais sinto que Lint é onde está o valor real.

Porque uma vez que a base de conhecimento cresce, sua maior dor de cabeça não é “não consigo obter respostas”, mas:

Frontmatter bagunçado
Nomes de autores inconsistentes
Tópicos dispersos
Estruturas históricas permanecendo no texto original
Páginas derivadas cada vez mais distorcidas
O mesmo conceito aparece sob vários nomes diferentes

Se você tentar manter isso manualmente, é enlouquecedor.

E você não conseguirá manter.

É exatamente nisso que a IA é melhor.

Não para entender o mundo por você.

Mas para patrulhar o vault, reconciliar, encontrar dados sujos e preencher referências cruzadas.

É por isso que o termo de Karpathy é tão adequado: contabilidade.

A Armadilha Real Não é o Modelo, é Meu Vault de Notas Antigo

Isso também é o que mais quero alertar a todos.

Muitas pessoas leem um artigo como este e pensam instintivamente:

“Ah, é só baixar a habilidade, instalar, e a IA vai gerenciar minha base de conhecimento.”

Não é o caso.

O maior desafio com esta habilidade não é o prompt, os scripts, ou mesmo o modelo.

É que eu tenho muitas notas antigas, e seus formatos são inconsistentes.

Quando executo lint agora, aqui está a escala que vejo:

Raw Sources do tipo artigo: 457
Total de arquivos brutos: 833
Fila pendente: 249
O diretório de backlinks já tem 471 tópicos

Pense nesse volume.

Isso não é mais sobre “organizar algumas notas”.

É mais como assumir um sistema antigo com uma longa história e sem padrões consistentes.

Alguns artigos têm nomes completos de autores.

Alguns têm aliases.

Alguns tópicos são muito detalhados.

Alguns são muito dispersos.

Alguns arquivos antigos ainda contêm resquícios de estruturas anteriores.

Então fiquei cada vez mais certo de uma coisa:

Se você quer construir um LLM Wiki, o primeiro passo não é deixar a IA assumir. O primeiro passo é limpar seu vault até um estado “que vale a pena assumir”.

Caso contrário, quanto mais diligente a IA, mais ela espalha a bagunça.

Então, o Que Esta Habilidade Faz de Extra?

Se você ler apenas o post original do Karpathy, pensará que é uma metodologia muito elegante.

Mas ao realmente construí-la, encontrei muitos detalhes de engenharia para preencher.

Por exemplo:

Padronização de frontmatter
Normalização de aliases de autores
Imposição de formato de backlink para tópicos
Separação completa das camadas bruta e derivada
Uso de 00-Inbox/ como caixa de entrada de processamento
Adição de portões de confirmação do usuário em etapas-chave
Divisão do fluxo de trabalho com scripts como lint, migrate, ingest

Não é que Karpathy não pensou nisso.

É que a Gist dele descreve um padrão, não a implementação específica para o seu vault.

Ao implementar de fato, você deve preencher essa camada você mesmo.

Minha habilidade obsidian-wiki atual está essencialmente fazendo isso:

Traduzindo um padrão abstrato em um fluxo de trabalho que roda no meu próprio vault do Obsidian.

Então, se você baixá-la, o mais importante a aprender não é “copiar minha estrutura de diretórios”.

É entender por que eu organizei as camadas dessa forma, por que a confirmação é necessária aqui, por que o lint é feito aqui, por que o apply automático não é usado aqui.

Se Você Quiser Fazer Isso Também, Modifique Estas Coisas Primeiro

Coloquei a versão sanitizada na página de download do meu blog:

https://blog.discoverlabs.ac.cn/downloads/obsidian-wiki-skill/

Mas depois de baixar, a primeira coisa não é executá-la.

É modificá-la.

Pelo menos verifique estas coisas:

O caminho do seu vault é o mesmo que o meu?
Sua estrutura 01-Notes/, 04-Output/, 00-Inbox/ é a mesma?
Seus campos de frontmatter são consistentes com os meus?
Seus nomes de autores e nomes de tópicos já são razoavelmente consistentes?
Você quer manter meu fluxo de trabalho de “sugerir, confirmar, depois escrever”?
Se os scripts envolvem APIs, você os substituiu por suas próprias chaves?

A versão que lancei já sanitizou chaves de API e caminhos locais.

Depois de obtê-la, você deve adaptá-la ao seu próprio ambiente.

E ainda recomendo: não trate meu método como um modelo, apenas como uma referência.

Se seu vault é principalmente notas de leitura, as regras podem diferir das minhas.

Se seu vault é principalmente notas de projeto, a granularidade dos tópicos será diferente.

Se seu vault ainda está na fase de “coletar primeiro, organizar depois”, você provavelmente não deve focar em Query primeiro, mas sim fazer Lint e Ingest funcionarem bem.

Então não copie na íntegra.

Modifique com base na abordagem, isso é mais confiável.

Resumo

Ao final deste artigo, meu próprio sentimento ficou mais claro.

A proposta de Karpathy não é apenas uma ideia de que “a IA pode ajudar você a organizar sua base de conhecimento”.

Seu valor real é que ela redefine a divisão de trabalho entre humanos e IA na gestão do conhecimento.

Humanos lidam com julgamento.

IA lida com contabilidade.

Quanto mais trabalho nisso, mais acredito nessa afirmação.

O que aprendi hoje:

A chave do LLM Wiki de Karpathy é a estrutura de três camadas e três operações, não um único prompt
A chave de habilidades como obsidian-wiki não é “se ela consegue resumir”, mas se consegue separar Raw Sources, Wiki e Schema
Na prática, Lint é frequentemente mais importante que Query, porque a limpeza de dados históricos é a maior parte do trabalho
Quanto mais notas antigas e mais bagunçado o formato, menos você deve copiar diretamente a habilidade de outra pessoa
Baixar uma habilidade é fácil; o verdadeiro desafio é adaptá-la para se adequar à sua própria base de conhecimento

Principais conclusões:

IA é mais adequada para contabilidade, não para pensar por você
Camadas bruta e derivada devem ser separadas, senão a base de conhecimento fica mais bagunçada quanto mais você organiza
Portões de confirmação do usuário não são etapas extras; são salvaguardas necessárias para evitar que a IA aja por conta própria
Padronize formatos primeiro, depois fale sobre automação; se inverter a ordem, você sofrerá depois
Esta habilidade pode ser modificada, mas não é recomendado copiá-la como está