# Obsidian五件对决Notion四件：知识入库赛道横评 ## 概述 这是本栏目 Skills 生态定期观察的第 7 轮，按惯例做同赛道竞品横评。本期选的赛道是「知识入库」——让 Claude 把对话、会议、研究材料沉淀成可检索的知识资产。评测对象全部来自本机真实装机：Obsidian 阵营五件（markdown、bases、mermaid、json-canvas、cli），Notion 阵营四件（knowledge-capture、meeting-intelligence、research-documentation、spec-to-implementation）。四份核心 SKILL.md 均已全文实读。核心发现一句话：同一场生意，两个阵营卖出两种世界观——一边教 Claude「写字」（把文件格式的方言规范塞给它），一边教 Claude「打电话」（把 API 编排流程单塞给它）。 ## 赛道背景：为什么知识入库值得横评 Claude Code 的会话是易逝的，关掉窗口，这轮对话里产生的结论、决策、坑就没了。于是「把知识存下来」成了 Skill 生态里的刚需赛道：不是让 Claude 更聪明，而是让它写的每一段字都落在正确的位置、以正确的格式。 这条赛道有两个天然流派。本地派以 Obsidian 为代表——知识就是一堆纯文本文件，仓库（vault）即数据库；云派以 Notion 为代表——知识是远端结构化数据库，页与页之间有关系、有状态、有负责人。两个流派的产品哲学不同，落到 SKILL.md 的写法上也截然不同，这正是本期横评最有看头的地方。 需要说明评测基础：本文所有设计分析来自对装机文件的一手实读，未做长跑实测；这批件均为本机装机，全网热度数据缺失，涉及「社区活跃度」一栏统一按基准分处理，宁缺毋假。 ## 评测对比表 | 件 | 功能完整度 25% | 设计质量 25% | 实战效果 20% | 上手难度 15% | 社区活跃度 15% | 加权总分 | |---|---|---|---|---|---|---| | obsidian-markdown | ★★★★★ | ★★★★ | ★★★★ | ★★★★★ | ★★★ | 4.25 | | obsidian-bases | ★★★★ | ★★★★ | ★★★★ | ★★★★ | ★★★ | 3.85 | | notion-knowledge-capture | ★★★★ | ★★★★ | ★★★ | ★★ | ★★★ | 3.35 | | notion-meeting-intelligence | ★★★★ | ★★★ | ★★★ | ★★ | ★★★ | 3.10 | 数据可得性说明：社区活跃度因无法核验公开热度，统一记基准三星，不参与区分度排名；实战效果按设计证据推演打分。 ## Obsidian 阵营：卖的是格式说明书 **obsidian-markdown：把一门方言写成了字典。** 定位极简：让 agent 能写出「合法的 Obsidian 风味 Markdown」。全文就是一部方言字典——wikilinks 双链、`^block-id` 块引用、十三种 callout 类型加自定义 CSS 扩展、PDF 按页嵌入（`![[doc.pdf#page=3]]`）、`%%注释%%`、frontmatter 属性类型表。亮点有三：一是覆盖密度高，从 CommonMark、GFM 到 LaTeX 数学的边界情况全部收口，连「表格里的竖线要转义」这种坑都写了；二是零依赖，没有一行脚本、没有一次外部调用，Claude 读完就能写，写完文件进 vault 即生效；三是文末把官方语法文档链接全部挂上，方便模型需要时二次查证。短板也明显：它是纯规范书，没有任务型引导——什么时候该用 callout 而不是标题、长笔记该拆几层，规范书不管，全靠模型自己拿捏。 **obsidian-bases：为最年轻的格式备好语法书。** Bases 是 Obsidian 较新的功能——用 `.base` 文件（YAML 格式）定义笔记的动态视图，相当于给纯文本仓库装上了数据库的眼睛。这件 Skill 把整套语法收进一份文件：全局 filters 的 and/or/not 嵌套、formula 公式语言（含日期运算、Duration 类型的坑——明确警告 Duration 不能直接 `.round()`，要先取 `.days`）、四种视图类型（table、cards、list、map）、十五种内置汇总公式。最值钱的是它把官方文档里散落的函数签名整理成了六大张速查表：全局函数、字符串、数字、列表、文件、正则。设计上比 markdown 那件更进一步：每个语法区块都配了「正确写法 vs 会报错的写法」对照，这是典型的防幻觉写法。短板：公式语言本身有学习成本，对没用过 Bases 的用户，上手比写普通笔记高一档。 **阵营其余成员**：装机里还有 obsidian-cli、obsidian-mermaid、json-canvas 三件，从命名与插件归属看分别对应命令行操作、笔记内画图、`.canvas` 画布格式，本期未逐件实读，不做内部展开。整个阵营的共性清晰可辨：每件只教一门「方言」，单文件成件，不依赖任何运行时。 ## Notion 阵营：卖的是操作流程单 **notion-knowledge-capture：把对话变成结构化页面的流水线。** 定位：把会话和零散笔记转成 Notion 里可复用、可链接的页面。它的 SKILL.md 是标准的工作流写法：先问清要沉淀什么（决策、how-to、FAQ、学习笔记、文档），再去 `reference/` 目录里挑对应数据库指南（team-wiki、how-to、FAQ、decision-log 等六种），用 `Notion:notion-search` 查重避免建重复页，然后 `notion-create-pages` 按数据库 schema 建页，最后回填 hub 页链接、补状态和负责人。亮点：reference 与 examples 分层、六种内容类型各配数据库模板，是教科书级的渐进式披露；「先查重再建页」这一步，体现出作者对知识库烂账的防御意识。短板在依赖链：整条流水线架在 Notion 官方远程 MCP 上，网络、OAuth、数据库 schema 缺一不可——它的第 0 步干脆写了一整节「MCP 连不上怎么办」。 **notion-meeting-intelligence：会议情报官。** 定位：会前拉动 Notion 里的历史上下文（过往纪要、spec、OKR、决策），按会议类型挑模板（status、decision、planning、retro、1:1、brainstorming 七套），产出带 owner 和时间盒的议程与 pre-read，会中计划变了还能 `notion-update-page` 回写。设计水准不低：模板选择指南单独成文件，examples 里放了高管汇报、项目决策等四个端到端案例。但两处减分：一是工作流里混入了「用 Codex 研究补充行业基准」这类宿主专属步骤，在别的宿主里跑会空转；二是流程步数多，会议这种时间敏感场景里，五步走完的准备链路对模型执行力是不小考验。 **阵营其余成员**：notion-research-documentation 与 notion-spec-to-implementation 两件同样在装，命名延续「动词+对象」风格，推测分别管研究材料归档与规格落地，未实读不展开。 ## 三回合正面对比 **第一回合，教学法：规范书对流程单。** Obsidian 阵营的 SKILL.md 是名词性的——它假定模型会做事，只缺一门语言的词汇表，于是把全部篇幅花在语法上；Notion 阵营是动词性的——模型词汇够用，缺的是步骤和模板，于是把篇幅花在工作流、数据库 schema 和模板选择指南上。两种写法没有高下，但边界很清楚：教格式的件，产出一辈子是文件；教流程的件，产出注定是 API 调用。 **第二回合，依赖链：零依赖对三重门。** Obsidian 阵营的依赖是零——能写文件就能跑，换个宿主、断个网都不影响。Notion 阵营要过三重门：远程 MCP 可达、OAuth 已登录、目标数据库已建好 schema。依赖换来了本地派给不了的东西——页面关系、状态字段、多人协作里的 owner 指派。这是单机文件和团队数据库的代价差，不是设计优劣。 **第三回合，失败模式：可见的对静默的。** Obsidian 件写错格式的后果是「渲染不对但看得见」，文件还在本地，随时可逆；Notion 件失败在链路上——MCP 断连直接中断流程，而且它的第 0 步给出的恢复方案 requiring 重启宿主，中断成本高。一个失败在内容层，一个失败在基础设施层，排障难度差着一个数量级。 ```mermaid flowchart TD subgraph OB["Obsidian阵营：教格式"] A1["要记一条知识"] --> A2["挑一种文件方言"] A2 --> A3["按规范写本地文件"] A3 --> A4["仓库即时生效"] end subgraph NT["Notion阵营：教流程"] B1["要记一条知识"] --> B2["MCP搜已有页面"] B2 --> B3["挑数据库与模板"] B3 --> B4["MCP建页或更新"] B4 --> B5["回填反链与负责人"] end A4 --> C["知识可检索"] B5 --> C ``` ## 两个彩蛋级发现 **其一，跨宿主件的活证据。** 两份 Notion 件的第 0 步里原样写着 Codex CLI 的指令——`codex mcp add notion --url https://mcp.notion.com/mcp`、在 `config.toml` 里开 `rmcp_client`、`codex mcp login notion`，连「登录后要重启 codex」都写了。也就是说，这套件是在另一个宿主的生态里写出来的，被整体搬进了 Claude Code 的装机。Skill 作为纯 Markdown 产物天然可移植，但流程单里埋着宿主专属命令，移植后就成了「半失效的说明书」——这大概是横评里最值得所有件作者警惕的一课：写件时想清楚它将来住在谁家。 **其二，同名件双装甚至三装。** 本机里 obsidian-bases、obsidian-markdown 既以散装件形式躺在用户 skills 目录，又作为 obsidian-skills 插件 1.0.0 的子件被缓存进插件目录——同一份知识两个入口。更典型的是 skill-creator：插件 example-skills 有一份，obsidian-skills 插件自带一份，用户散装目录还有一份，同名件三拷贝同场竞技。哪份被调用取决于宿主的解析顺序，这既是生态繁荣的副产品，也是用户排障时的暗坑。 ```mermaid flowchart TD P1["插件 example-skills"] --> S["skill-creator"] P2["插件 obsidian-skills"] --> S P3["用户散装目录"] --> S S --> Q["同名件三拷贝：看解析顺序"] ``` ## 安装与使用 **Obsidian 阵营**（零依赖，装完即用）：把件目录放进 `~/.claude/skills/` 即可，本机另有一路安装是 obsidian-skills 插件（缓存路径形如 `plugins/cache/obsidian-skills/obsidian/1.0.0/`）。用法直接说人话触发：「把这周笔记整理成一个按状态分组的 base 视图」「给这篇笔记加上 callout 和双链」。 **Notion 阵营**（先通链路再谈触发）：件目录同样放 `~/.claude/skills/`，但必须先把 Notion 官方远程 MCP（`https://mcp.notion.com/mcp`）注册进宿主并完成 OAuth 登录——SKILL.md 原文给的是 Codex 三步命令，Claude Code 下等价做法是把同一地址挂为本机 MCP 后重启。触发示例：「把刚才这段讨论沉淀成 FAQ 页」「给我明天的评审会出一份 pre-read」。 ## 推荐排行榜 - **零配置新手首选**：obsidian-markdown——拖进目录就能用，第一条知识一分钟入库。 - **进阶玩家之选**：obsidian-bases——想让本地仓库长出数据库视图，它是唯一的敲门砖。 - **团队协作首选**：notion-knowledge-capture——六种数据库模板加查重前置，多人知识库不烂账。 - **会议重度用户**：notion-meeting-intelligence——七套模板最全，但请先确保 MCP 链路稳定。 - **可移植性冠军**：整个 Obsidian 阵营——断网、换宿主、换机器，文件在知识就在。 ## 写在最后 把九件摆上同一张桌子，看明白的其实不是谁赢谁输，而是这条赛道的分工：Obsidian 阵营赚的是「个人第二大脑」的钱，用最笨也最稳的方式——把格式规范写透，让模型落笔即合法；Notion 阵营赚的是「团队知识运营」的钱，用流程和模板把 API 编排的混乱兜住。单人本地党选前者，团队云库党选后者，两条路线在同一个宿主里完全可以在。真正要小心的是那两个彩蛋：跨宿主移植的半失效说明书，和同名件多拷贝的解析暗坑——生态越长越大，装机单越来越厚，这两类问题只会更多。 ## 参考来源 1. [Obsidian Bases Syntax](https://help.obsidian.md/bases/syntax) — obsidian-bases 件文末引用的官方语法文档，本文 Bases 功能描述的权威出处 2. [Obsidian Flavored Markdown](https://help.obsidian.md/obsidian-flavored-markdown) — obsidian-markdown 件引用的官方方言文档 3. [Obsidian Callouts](https://help.obsidian.md/callouts) — 十三种 callout 类型的官方定义 4. [Notion Remote MCP](https://mcp.notion.com/mcp) — Notion 官方远程 MCP 服务地址，引自两份 Notion 件 SKILL.md 第 0 步原文 5. [anthropics/skills](https://github.com/anthropics/skills) — 官方 Skills 仓库，本机 example-skills 插件对应的上游生态入口；本期四份 SKILL.md 全文均为本机装机实读 > [!tip] 51学通信知识星球 > **星主：爱卫生**（微信：gprshome201101）——公众号「51学通信」创办者，19 年通信行业运维与讲师经验，著有《GPRS网络信令实例详解》《EPC原理与实践》《5G核心网原理与实践》三本纸质书（各大电商平台有售）。 > **星球定位**：深耕 5G 核心网、IMS、NFV/AI、云原生等 ICT 领域，主打运维岗位与信令分析。 > **当前规模**：5200 篇主题 / 990 个回答，198 元/年。 > **加入福利**：加入星球后请加爱卫生微信，拉您进知识星球年度陪伴与答疑群——不限量回复您的各种问题，另有群内分享。 > **AI 加持**：51学通信知识星球已作为 skill 接入 WorkBuddy，使用 deepseek-4-flash 在海量星球帖子中精准找贴、找视频、找 FAQ 和案例，做总结、找文档和 PPT 等场景全覆盖。