obsidian

O que obsidian faz?

Use a CLI oficial obsidian para trabalhar com vaults do Obsidian. Os arquivos do vault são Markdown puro, então edições diretas nos arquivos ainda são adequadas quando forem mais seguras ou rápidas.

Requisitos

• Obsidian 1.12.7+ instalado.
• Configurações -> Geral -> Interface de linha de comando ativada.
• obsidian registrado no PATH.
• Aplicativo Obsidian em execução; a CLI se conecta ao aplicativo em execução.

Verifique:

obsidian version
obsidian help

No macOS, o registro cria /usr/local/bin/obsidian apontando para a CLI do pacote do aplicativo. No Linux, o registro copia o binário para ~/.local/bin/obsidian.

Modelo de vault

• Notas: *.md.
• Configuração: .obsidian/; evite editar a menos que solicitado.
• Canvases: *.canvas JSON.
• Anexos: pasta configurada no vault.
• Vaults múltiplos são comuns; use vault="<nome>" quando houver ambiguidade.

O Obsidian desktop rastreia os vaults em:

• ~/Library/Application Support/obsidian/obsidian.json

Padrão de comandos

obsidian <comando> [nome=valor] [flag]
obsidian vault="Notas" search query="notas de reunião" format=json

Valores de parâmetros com espaços precisam de aspas. Adicione --copy para copiar a saída quando útil.

Comandos comuns

Abrir/Ler:

obsidian open file=Receita
obsidian open path="Inbox/Idea.md" newtab
obsidian read
obsidian read file=Receita

Pesquisar:

obsidian search query="TODO" matches
obsidian search query="status::active" format=json
obsidian search:open query="notas do projeto"

Criar/Modificar:

obsidian create name="Nova Nota"
obsidian create path="Inbox/Idea.md" content="# Ideia"
obsidian append file=Nota content="Nova linha"
obsidian prepend file=Nota content="Após metadados"

Mover/Excluir:

obsidian move file=Nota to=Arquivo/
obsidian move path="Inbox/Antiga.md" to="Projetos/Nova.md"
obsidian delete file=Nota

Diárias/Tarefas:

obsidian daily
obsidian daily:read
obsidian daily:append content="- [ ] Revisar caixa de entrada"
obsidian tasks all todo
obsidian task file=Nota line=8 done

Propriedades/Links:

obsidian tags all counts
obsidian property:read file=Nota name=status
obsidian property:set file=Nota name=status value=feito
obsidian backlinks file=Nota
obsidian unresolved verbose counts

Desenvolvimento/Depuração:

obsidian plugin:reload meu-plugin
obsidian dev:errors
obsidian dev:screenshot file=captura.png
obsidian eval "app.vault.getFiles().length"

Observações

• file=<nome> usa a resolução de arquivos do Obsidian; path=<relativo-ao-vault.md> é exato.
• Prefira comandos CLI para mover, excluir e definir propriedades, pois são atualizações conscientes do Obsidian.
• Prefira edições diretas em Markdown para alterações em massa de texto, após localizar o caminho do vault.
• Não dependa do obsidian-cli de terceiros, a menos que o usuário peça explicitamente por ele.