Obsidian

Obsidian 仓库（vault）= 磁盘上一个包含 Markdown 文件的普通文件夹。

仓库结构（典型）：

• 笔记： *.md（纯文本 Markdown；可用任意编辑器编辑）
• 配置： .obsidian/（工作区 + 插件设置；请勿通过脚本修改）
• 画布： *.canvas（JSON 格式）
• 附件：你在 Obsidian 设置中指定的任意文件夹（如图片、PDF 等）

设置

查找当前激活的仓库（vault）

Obsidian 桌面端在配置文件中记录所有仓库（该文件为唯一可信来源）：

• macOS：~/Library/Application Support/obsidian/obsidian.json
• Linux：~/.config/obsidian/obsidian.json

notesmd-cli 从该配置文件解析仓库列表；仓库名称即其文件夹名（路径后缀）。

验证默认仓库

执行任何命令前，请务必先确认默认仓库：

notesmd-cli print-default --path-only 2>/dev/null && echo "OK" || echo "NOT_SET"

若输出 NOT_SET，请配置默认仓库：

notesmd-cli set-default "VAULT_NAME"

切勿猜测仓库路径 —— 请直接读取配置文件，或使用 print-default 命令获取准确路径。

notesmd-cli 快速参考

仓库信息

notesmd-cli print-default              # 显示默认仓库名称及路径
notesmd-cli print-default --path-only  # 仅显示路径
notesmd-cli list                       # 列出仓库内所有笔记与文件夹
notesmd-cli list "Folder"              # 列出指定文件夹内的内容

搜索

notesmd-cli search "query"             # 模糊匹配笔记标题
notesmd-cli search-content "query"     # 在笔记正文中搜索（显示匹配片段及所在行）

读取

notesmd-cli print "path/note"          # 输出笔记全文内容
notesmd-cli frontmatter "path/note"    # 查看或修改笔记的 frontmatter

创建与编辑

notesmd-cli create "Folder/Note" --content "..." --open    # 创建新笔记
notesmd-cli create "Folder/Note" --content "..." --append  # 追加内容至已有笔记
notesmd-cli create "Folder/Note" --content "..." --overwrite  # 覆盖已有笔记

注意：create 命令依赖 Obsidian URI 处理器（需已安装 Obsidian）。请避免使用隐藏的点文件夹路径（如 .folder/）。

移动 / 删除

notesmd-cli move "old/path/note" "new/path/note"  # 重命名或移动（自动更新 [[wikilinks]]）
notesmd-cli delete "path/note"

多仓库支持

在任意命令后添加 --vault "Name" 参数即可指定目标仓库：

notesmd-cli print "2025-01-10" --vault "Work"
notesmd-cli search "meeting" --vault "Personal"

每日笔记

notesmd-cli daily                      # 打开或创建今日的每日笔记
notesmd-cli daily --vault "Work"       # 指定特定仓库

获取当前日期（跨平台）

date +%Y-%m-%d                         # 今天
# 昨天（GNU 版优先，BSD 版作为备选）：
date -d yesterday +%Y-%m-%d 2>/dev/null || date -v-1d +%Y-%m-%d
# 上周五：
date -d "last friday" +%Y-%m-%d 2>/dev/null || date -v-friday +%Y-%m-%d
# N 天前：
date -d "3 days ago" +%Y-%m-%d 2>/dev/null || date -v-3d +%Y-%m-%d

向每日笔记追加内容

# 日志条目
notesmd-cli create "$(date +%Y-%m-%d)" --content "- Did the thing" --append

# 待办任务
notesmd-cli create "$(date +%Y-%m-%d)" --content "- [ ] Buy groceries" --append

# 带时间戳的日志
notesmd-cli create "$(date +%Y-%m-%d)" --content "- $(date +%H:%M) Meeting notes here" --append

# 指定自定义文件夹（例如 Daily Notes 插件所用文件夹）
notesmd-cli create "Daily Notes/$(date +%Y-%m-%d)" --content "- Entry" --append

读取某日的每日笔记

notesmd-cli print "$(date +%Y-%m-%d)"  # 今日
notesmd-cli print "$(date -d yesterday +%Y-%m-%d 2>/dev/null || date -v-1d +%Y-%m-%d)"  # 昨日
notesmd-cli print "2025-01-10"         # 指定日期

常用模式

创建含内容的新笔记：

notesmd-cli create "Projects/My Project" --content "# My ProjectnnNotes here." --open

查找并读取笔记：

notesmd-cli search "meeting"
notesmd-cli print "path/from/search/result"

安全重命名（保持 wikilink 引用完整）：

notesmd-cli move "old/note name" "new/folder/note name"

在笔记正文中搜索：

notesmd-cli search-content "TODO"
notesmd-cli search-content "project alpha"

在适用场景下，可直接编辑 .md 文件（无需 CLI），Obsidian 会自动识别变更。