Obsidian笔记CLI

Obsidian笔记命令行工具，支持笔记搜索、批量处理、统计分析、导出转换、标签管理等功能，直接操作本地Obsidian知识库。

Obsidian Notesmd CLI 命令行工具

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

核心功能

1. 笔记搜索

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

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

2. 知识库统计

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

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

3. 批量操作

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

4. 链接管理

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

使用方法

基础命令

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

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

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

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

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

常用参数

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

示例

# 统计我的知识库信息
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:\导出的工作笔记"