Obsidian CLI 技能全解析：从基础操作到高效工作流构建

2次阅读

共计 1733 个字符，预计需要花费 5 分钟才能阅读完成。

最近用时间追踪工具统计发现，我平均每天要花 35 分钟在 Obsidian 里做重复劳动：手动创建模板、批量修改链接格式、跨笔记同步标题 …… 这些机械操作不仅消耗精力，还容易出错。更扎心的是，同事用 CLI 工具完成同样任务，耗时只有我的 1 /5。

实测对比数据：

创建 100 篇笔记模板
GUI 操作：4 分 12 秒（包含界面切换等待）
CLI 命令：9.8 秒（obsidian-cli new -t daily_note -n 100）
替换所有 [[旧术语]] 为[[新术语]]
手动查找替换：6 分 33 秒（需逐个确认）
管道组合命令：2.1 秒（grep -rl '旧术语' | xargs sed -i 's/ 旧术语 / 新术语 /g'）

# 通过 npm 安装（需 Node.js 环境）npm install -g obsidian-cli

# 验证安装
obsidian-cli --version

# 列出所有保险库
obsidian-cli vault list

# 切换当前保险库
obsidian-cli vault use /path/to/vault

# 创建带 YAML frontmatter 的笔记
obsidian-cli new --title "项目复盘" --tags "work,review"

# 批量生成周报模板（周一至周五）for day in 月 火 水 木 金; do
  obsidian-cli new -t weekly_report -n "周报_$day"
done

# 找出所有包含 [[旧链接]] 的 MD 文件
grep -rl '\[\[旧链接 \]\]' ./ | while read file; do
  # 替换为![](新链接.png)格式
  sed -i 's/\(\[\[\)旧链接 \(\]\]\)/![](新链接.png)/g' "$file"
  # 自动提交 Git 变更
git add "$file"
done

手工操作：需逐个文件 Ctrl+ H 替换，约 8 分钟 /100 文件
脚本执行：全自动处理，平均 0.3 秒 / 文件

from typing import List
from obsidian_cli import Note, Vault

def bulk_update_tags(vault_path: str, old_tag: str, new_tag: str) -> int:
    """批量更新标签（带类型注解）"""
    count = 0
    vault = Vault(vault_path)
    for note in vault.notes():
        if old_tag in note.tags:
            note.tags.remove(old_tag)
            note.tags.append(new_tag)
            note.save()
            count += 1
    return count

现象：多个脚本同时写笔记导致内容截断

解决方案：

# 使用 flock 加锁
flock -x .obsidian.lock -c 'obsidian-cli modify --file important.md'

# Python 处理示例
from pathlib import Path

note_path = Path('笔记 / 中文标题.md').resolve().as_posix()  # 转 UTF- 8 路径

# 关键操作前自动拉取最新变更
git -C /vault/path pull --rebase

# 批量操作后立即提交
git -C /vault/path commit -am "CLI 批量更新" && git push

提供 benchmark.sh 测试脚本（下载链接），可测量不同规模笔记集的处理耗时。实测数据：

笔记数量	创建(s)	批量更新(s)
100	1.2	3.8
1000	9.7	28.4
10000	86.5	217.2

自从把 80% 的日常操作迁移到 CLI，我的 Obsidian 使用时间从日均 1.5 小时降到 40 分钟。最惊喜的是可以边写代码边用 watch 命令监控笔记变更，彻底告别鼠标在多个窗口间来回切换的痛苦。现在甚至用 CLI 实现了自动化周报生成 +Git 提交 + 企业微信通知的完整流水线，这才是知识工具该有的样子。

正文完