notesmd-cli 安装与使用

背景

notesmd-cli（原名 obsidian-cli）是一个 Go 语言编写的命令行工具，用于在终端中与 Obsidian vault 交互。支持搜索、创建、编辑笔记等操作。

早期版本叫 Yakitrak/obsidian-cli，后更名为 notesmd-cli。

安装过程

踩坑：错误的 obsidian-cli

[!warning] 装错了包
npm 上的 obsidian-cli 实际上是 Obsidianqa（测试管理平台）的 CLI，不是 Obsidian 笔记工具的 CLI。初始安装成功后，会发现不支持 set-default、search、create 等命令，功能完全不匹配。

正确安装方式

由于 brew tap 已失效，直接从 GitHub Releases 下载预编译二进制：

# 下载 darwin 版本
curl -sL https://github.com/Yakitrak/notesmd-cli/releases/download/v0.3.5/notesmd-cli_0.3.5_darwin_all.tar.gz -o notesmd-cli.tar.gz

# 解压
tar xzf notesmd-cli.tar.gz

# 移动到 PATH
cp notesmd-cli ~/.local/bin/notesmd
chmod +x ~/.local/bin/notesmd

# 设置别名（可选）
ln -sf ~/.local/bin/notesmd ~/.local/bin/ob

设置默认 Vault

notesmd set-default-vault zhengxi_wiki

这会自动将默认 vault 设为 /Users/zhengxi/Desktop/zhengxi_wiki。

常用命令

# 查看 vault 笔记
ob list

# 模糊搜索笔记名称
ob search "关键词"

# 全文搜索
ob search-content "关键词"

# 创建笔记
ob create "文件夹/笔记名" --content "# 标题"

# 查看内容
ob print "笔记名"

# 移动/重命名（自动更新 wiki 链接）
ob move "旧路径" "新路径"

# 在 Obsidian 中打开
ob open "笔记名"

注意事项

[!info] 使用前提

• 该工具需要 Obsidian 已安装并配置好 vault
• set-default-vault 只需执行一次，后续命令无需指定 vault
• ob 别名在 ~/.zshrc 中配置了 ~/.local/bin 到 PATH，新开终端生效