找以前写过的相关内容把零散素材合并成草稿给文章补摘要、标签和标题检查引用和双向链接把正文整理成适合发布的平台格式记录这篇内容后续还能延展成哪些选题这些动作手动做当然可以但时间久了会很耗精力。Obsidian CLI 的意义就是让这些动作可以被命令、脚本和 AI 工具接管一部分。也就是说Obsidian 不再只是一个打开来写字的软件。它开始变成一个可以被外部工具调用的本地知识工作台。怎么开启 Obsidian CLI现在建议直接使用最新版 Obsidian 安装器。官方文档要求使用 Obsidian 1.12 系列安装器当前推荐使用 1.12.7 或更新版本Windows 上则明确需要 1.12.7 安装器因为新版安装器已经改进了 CLI 的二进制文件和终端交互速度。开启方式很简单更新 Obsidian 到最新版安装器。打开 Obsidian。进入Settings - General。开启Command line interface。完成 CLI 注册。这里的“注册”不是注册账号也不是登录 Obsidian 账号而是让系统认识obsidian这个命令。不同系统背后做的事情不一样WindowsObsidian 1.12.7 安装器会在安装目录里提供Obsidian.com终端转发器。开启 CLI 后Obsidian 会把它注册到当前用户的 PATH 里。注册完成后一定要重新打开 PowerShell、Windows Terminal 或 CMD。macOSObsidian 会在/usr/local/bin/obsidian创建一个软链接指向 App 内置的 CLI 程序。这一步可能会弹出系统权限确认需要输入管理员密码。LinuxObsidian 会把 CLI 程序复制到~/.local/bin/obsidian。如果终端还是找不到命令要确认~/.local/bin是否已经加入 PATH。重启终端让 PATH 配置生效。然后在新的终端里先执行obsidian version如果能看到版本号再执行obsidian help如果能看到命令列表就说明 CLI 已经可用。如果命令还是不可用可以回到Settings - General把Command line interface关掉再打开一次让 Obsidian 重新注册。注册后仍然要重启终端。这里有一个细节Obsidian CLI 需要 Obsidian 桌面端运行。官方文档说明如果 Obsidian 没有运行第一次执行命令会先启动 Obsidian。它不是一个完全脱离桌面端的后台服务。最常用的几个命令刚开始不用记太多命令先记住几类就够了。1. 搜索知识库obsidian search queryAI 工作流如果想看匹配行的上下文可以用obsidian search:context queryAI 工作流这对写文章很有用。比如要写一篇关于 AI 创作系统的文章可以先搜整个 Vault(知识库文件夹)里所有提到这个主题的笔记再决定哪些内容可以复用。2. 创建一篇新笔记obsidian create nameObsidian CLI 选题 content# Obsidian CLI 选题\n\n这里记录文章思路。也可以指定路径obsidian create path40 微信公众号/20 草稿/新文章草稿.md content# 新文章草稿如果已经有模板还可以用模板创建obsidian create name新文章草稿 template文章模板这类命令适合把固定写作流程标准化。比如每次新建公众号草稿时都自动带上标题、摘要、标签、状态和参考资料区。3. 读取和追加内容obsidian read file从 Notion 到 Obsidianobsidian append file从 Notion 到 Obsidian content\n\n这里补充一段新的想法。读取和追加是最适合接入 AI 工具的能力。AI 可以先读取文章草稿再按写作要求补一个结尾、生成摘要、整理标题或者把某一段改成更适合公众号阅读的表达。4. 查看链接关系这组命令最容易看懵因为它们都和链接有关但看的方向不一样。先记住一句话backlinks看谁指向我links看我指向谁unresolved看整个库里哪些链接还没有对应文件。比如要检查这篇文章obsidian backlinks path40 微信公众号/40 已发布/Obsidian CLI 来了.md counts这条命令看的不是文章里写了哪些链接而是反过来看知识库里有哪些笔记提到了Obsidian CLI 来了。backlinks就是反向链接。它适合回答这个问题这篇文章有没有被其他笔记引用后面的counts表示把引用次数也带出来。如果同一篇笔记里多次链接到它输出里能看到数量。再看出链obsidian links path40 微信公众号/40 已发布/Obsidian CLI 来了.mdlinks看的是这篇文章主动链接到了哪些笔记。比如一篇文章里链接了[[AI 工作流]]、[[写作素材]]、[[Obsidian CLI]]这些笔记它们就属于出链。它适合回答这个问题这篇文章接到了哪些已有内容如果只想知道出链数量可以加totalobsidian links path40 微信公众号/40 已发布/Obsidian CLI 来了.md total最后看未解析链接obsidian unresolved counts这条命令和前两条不一样。它不是检查某一篇文章而是检查整个 Vault(知识库文件夹)。unresolved会列出那些已经写成[[某个标题]]但当前知识库里还没有对应.md文件的链接。这类链接在 Obsidian 里通常会显示成还没创建的笔记。它不一定是错误也可能是提前留下的选题或概念坑。后面的counts表示统计每个未解析链接出现了多少次。如果想看这些未解析链接分别出现在哪些文件里可以用obsidian unresolved counts verbose如果终端输出是No unresolved links found.这反而是好结果说明当前 Vault(知识库文件夹)里没有写了链接但还没创建文件的笔记。也就是说现有的[[双向链接]]都能找到对应内容。这条命令适合回答这个问题我的知识库里有哪些链接还没有变成真实笔记这几条命令对应的是 Obsidian 的核心优势双向链接和知识网络。写作时最怕内容孤立。文章写完了但它和以前的笔记没有连接后面就很难重新被用上。所以这三条命令可以形成一个很实用的检查流程先用links看这篇文章有没有主动接到已有笔记。再用backlinks看有没有其他内容反过来引用它。最后用unresolved counts verbose看整个库里还有哪些链接只是占位还没有真正沉淀成笔记。这样一篇文章就不是孤零零地放在文件夹里而是被接进了整个知识网络。5. 管理任务和标签obsidian tasks todo如果输出是No tasks found.意思是当前 Vault(知识库文件夹)里没有未完成任务。这里的任务通常指 Markdown 里的待办项比如- [ ] 整理 Obsidian CLI 截图。如果笔记里没有写这种待办看到这个结果很正常。obsidian tags countstags counts会统计每个标签出现了多少次。比如下面这组结果里#知识管理和#Obsidian出现次数最多说明当前知识库的内容重心主要集中在这两个方向。#知识管理 9 #Obsidian 9 #demo 3 #Markdown 3 #AI 2 #Codex 2这个命令适合用来判断内容池的主题分布。写公众号时它能显示哪些方向已经有素材哪些标签只是偶尔出现还没有形成稳定主线。如果选题、写作计划、发布状态都放在 Obsidian 里tasks todo能看出还有哪些任务没做tags counts能看出哪些主题最常被记录。它和 Codex 能怎么配合Obsidian CLI 真正有想象力的地方是它可以和 Codex 这类本地 AI 编程/写作助手配合。以前让 AI 辅助写文章通常要先把内容复制给它。写完以后再复制回来。这个流程很割裂。如果资料本来就在 Obsidian 里而 Obsidian 又能被 CLI 调用流程就会自然很多Codex 先搜索 Vault(知识库文件夹)找到相关笔记。读取文章草稿和关联素材。根据写作要求补正文、改标题、写摘要。创建新的概念卡片或 demo 文件。检查哪些双向链接没有落到真实文件。最后把文章整理成适合发布的平台格式。这个过程中AI 不只是站在知识库外面给建议而是在本地文件结构里协作。比如继续写 Obsidian CLI 相关内容时Codex 可以先搜索知识库里和 AI 工作流、写作素材、双向链接相关的笔记再把新文章接到这些已有主题上。读者看到的是一篇文章背后其实是一整套本地素材网络在支撑。这就是本地 Markdown 的价值。资料不是被锁在某个在线产品里而是可以被终端、脚本、Git、Obsidian 和 AI 工具共同处理。不要把判断交给工具Obsidian CLI 很强但它不是魔法。它能提高效率不能替创作者判断什么内容值得写。它能创建笔记不能替创作者决定一篇文章的观点是否成立。它能检查链接不能保证知识结构本身就有价值。更重要的是CLI 可以改文件、移动文件、删除文件。越是自动化越要注意备份。我的建议是重要 Vault(知识库文件夹) 用 Git 管理版本。大批量操作前先提交一次。不熟悉的命令先用测试笔记验证。删除、移动、覆盖这类动作不要直接交给陌生脚本。AI 可以辅助整理但最终发布前一定自己通读一遍。为什么这是一个重要变化Obsidian CLI 的重点不在于多了几个命令。它真正带来的变化是把 Obsidian 从“写作软件”往“本地知识操作系统”推进了一步。过去知识库主要解决保存问题资料放在哪里怎么分类怎么搜索。现在知识库还要解决流动问题资料能不能被自动化流程调用能不能被 AI 理解和重组能不能在下一篇文章、下一个项目、下一次复盘里继续发挥作用。这也是 Obsidian 值得被更认真看待的原因。它不是 Notion 的平替也不是单纯的 Markdown 编辑器。它的价值在于把本地文件、双向链接、图谱、插件、CLI、AI 工具连接到一起形成一套更长期、更开放的创作系统。对于普通用户Obsidian CLI 可能暂时不是每天都要用的功能。但对于长期写作、做内容、做知识管理、做 AI 工作流的人来说它是一个很重要的信号以后的个人知识库不应该只是给人看的页面。它还应该是能被工具调用、能被自动化处理、能和 AI 一起工作的本地资产。参考资料Obsidian CLI 官方文档Obsidian CLI - Obsidian HelpObsidian 1.12 Desktop 发布记录Obsidian 1.12 Desktop (Public) - ObsidianObsidian 1.12.7 Desktop 发布记录Obsidian 1.12.7 Desktop (Public) - Obsidian标签: Obsidian免责声明本内容来自平台创作者博客园系信息发布平台仅提供信息存储空间服务。好文要顶 关注我 收藏该文 微信分享BNTang粉丝 - 173 关注 - 16加关注30升级成为会员« 上一篇 从 Notion 到 Obsidian» 下一篇 大数据没那么远把散乱数据理顺让业务敢用posted 2026-04-27 21:27 BNTang 阅读(1103) 评论(2) 收藏 举报
