### [Obsidian Markdown 开源Skill官网直达 – 把零散笔记整理成能回找的知识库](https://www.zuoshipin.com/)

**Published:** 2026-09-03T05:08:47

**Author:** AI_Tools

**Excerpt:** Obsidian 作者 Steph Ango（kepano）公开的 Agent Skill，教 Agent 正…

Obsidian 作者 Steph Ango（kepano）公开的 Agent Skill，教 Agent 正确使用双向链接、属性、嵌入和提示块。适合把会议记录、读书笔记和项目资料整理为结构清楚的本地 Markdown 笔记。它不是云端知识库，也不负责自动抓取你所有文件。

收藏夹越存越多，真正用时却找不到：上周客户提了什么要求？这条结论出自哪次会议？这个 Skill 的价值不是再写一篇摘要，而是让笔记之间形成可追踪的联系。你可以要求它按项目归档、补充标签，把关联文档写成 \[\[双向链接\]\]，再将结论、风险和待办分开。

![Obsidian Markdown：安装与使用流程示意（AI制图，不是实际软件输出）](https://admin.zuoshipin.com/wp-content/uploads/2026/09/public-skills-01-obsidian-card-20260903.webp)

Obsidian Markdown：安装与使用流程示意（AI制图，不是实际软件输出）

### 安装：先把前提配齐

本文的命令使用 Skills CLI，只安装指定名称，不一次装入整个仓库。需要 Node.js 22.20.0 或更高版本（当前 CLI 要求）、npm/npx、Git，以及已经可正常使用的 Agent。请先审阅仓库和脚本，再授权执行。

命令末尾的 -a claude-code codex 表示为这两种宿主安装；只用 Claude Code 就保留 -a claude-code，只用 Codex 就保留 -a codex。默认安装在当前项目，不加 -g；只有确实想全局使用时才考虑 -g。安装目录以命令实际输出为准。

1.  先准备一个测试文件夹，放入两三份脱敏的 Markdown 笔记；建议用 Obsidian 将该文件夹作为仓库打开，方便预览。不要第一次就授权修改整个私人知识库。
2.  在终端进入这个项目目录，运行下面的单技能安装命令。安装的是完整 Skill 目录及 references，不是只复制一个 SKILL.md。
3.  在同一项目打开 Agent 新会话，指定可以读取的笔记目录。已有 Obsidian 仓库时，先备份；本例只新增笔记，不移动或删除原文件。

```
npx skills add kepano/obsidian-skills --skill obsidian-markdown -a claude-code codex
```

### 使用：从一个小任务开始

1.  先让 Agent 阅读指定文件，列出拟定的标题、标签和关联关系，确认它没有把不同项目混在一起。
2.  确认后生成整理后的笔记和索引页。原文未写明的负责人、日期、结论，要求标为“待确认”，不要让它自行补齐。
3.  用 Obsidian 阅读视图检查属性、提示块和链接；点开几个双链确认目标存在。发现空链接，先核对名称再修正。

### 这段提示词，可以直接改着用

> 请使用 obsidian-markdown，整理 notes/inbox 中这3份项目会议笔记。先给我整理计划，确认后在 notes/organized 新建笔记，添加 title、tags、aliases，用 \[\[双向链接\]\] 关联同一项目。分别保留事实、决策、待办和待确认信息，并生成一个项目索引页。不要改写原文件，不要杜撰负责人或截止日期。

### 做到哪一步，才算真正跑通？

你应该得到若干 .md 笔记和一页索引，而不是一个聊天摘要。检查要点是：来源保留、双链可打开、待办可追踪、没有覆盖原始记录。

**常见问题：**如果 Agent 只在聊天里输出内容，明确要求保存到哪个目录，并确认文件写入权限；如果出现 \[\[空链接\]\]，提供真实笔记文件名。安装这个 Skill 不代表同时安装仓库里其他4个 Skill。

**边界与费用：**它提供的是 Obsidian Markdown 编写规范，不等于全文检索引擎，也不会自动安装 Obsidian 软件或 obsidian-cli。批量读取和写文件由宿主 Agent 执行；使用云端模型时，本地笔记也可能进入模型服务的处理链路。

![Obsidian Markdown 官方 GitHub / SKILL.md 页面截图，2026年9月3日](https://admin.zuoshipin.com/wp-content/uploads/2026/09/public-skills-01-obsidian-shot-20260903.webp)

Obsidian Markdown 官方 GitHub / SKILL.md 页面截图，2026年9月3日

**公开源码：**[https://github.com/kepano/obsidian-skills/tree/main/skills/obsidian-markdown](https://github.com/kepano/obsidian-skills/tree/main/skills/obsidian-markdown)

**代码许可：**MIT。许可覆盖范围以仓库 LICENSE 为准，第三方服务和素材另行遵守各自条款。



---