Obsidian Notesmd CLI 命令行工具#

直接操作本地Obsidian知识库（Vault），无需打开Obsidian客户端即可完成批量操作、统计分析、内容搜索等功能。

核心功能#

1. 笔记搜索#

支持全文搜索、标题搜索、标签搜索、按日期范围筛选：

• 支持关键词高亮
• 支持正则表达式搜索
• 搜索结果按相关度排序

2. 知识库统计#

自动生成知识库统计报告：

• 总笔记数量、总字数、总附件大小
• 标签数量、标签使用频率排名
• 近7/30/90天新增笔记数量
• 文件类型分布统计

3. 批量操作#

• 批量替换所有笔记中的指定文本
• 批量给符合条件的笔记添加/删除标签
• 批量导出笔记到指定目录
• 批量清理空笔记、重复笔记

4. 链接管理#

• 提取所有笔记的双向链接关系
• 检测孤立笔记（没有任何入链出链的笔记）
• 检测死链（指向不存在的笔记的链接）
• 导出链接关系数据用于生成关系图谱

使用方法#

基础命令#

powershell

# 搜索笔记
obsidian-cli search "关键词" --vault "你的知识库路径"

# 生成知识库统计报告
obsidian-cli stats --vault "你的知识库路径"

# 批量替换内容
obsidian-cli replace "旧文本" "新文本" --vault "你的知识库路径"

# 导出所有笔记
obsidian-cli export --output "导出目录路径" --format markdown

# 检测死链
obsidian-cli check-links --vault "你的知识库路径"

常用参数#

参数说明必填--vaultObsidian知识库根目录路径✅--output导出结果保存路径❌--format导出格式：markdown/html/txt/json默认markdown--case-sensitive搜索/替换是否区分大小写默认不区分--regex是否启用正则表达式匹配默认不启用--include-attachments导出时是否包含附件默认不包含

示例#

powershell

# 统计我的知识库信息
obsidian-cli stats --vault "D:\我的知识库"

# 搜索所有包含"AI大模型"的笔记
obsidian-cli search "AI大模型" --vault "D:\我的知识库"

# 把所有笔记中的"GPT-4"替换为"GPT-4o"
obsidian-cli replace "GPT-4" "GPT-4o" --vault "D:\我的知识库" --case-sensitive

# 导出所有带"工作"标签的笔记
obsidian-cli export --vault "D:\我的知识库" --tag "工作" --output "D:\导出的工作笔记"