Obsidian 本地知识库搭建指南

来源：X @ai_xiaomu

直接问大模型，得到的回答往往是通用的；把自己的素材、方法论、经历、判断喂进去，输出才会带上个人印记 ^[0]。Obsidian 是为这个目的设计的软件：本地优先、基于 Markdown 文件，特点是双向链接和插件生态，适合笔记体量大、想长期沉淀知识的人 ^[0]。下文按安装到使用的顺序介绍，其中两处说法——“只有云同步和在线发布两个付费服务”和”社区插件有官方审核所以安全”——会单独澄清。

本地优先：你的笔记是一堆纯文本文件

Obsidian 的所有笔记都是电脑上的 .md 文本文件，不依赖任何云端 ^[0]。官方明确数据完全由用户控制，以明文 Markdown 存储在本地，无需账号、无广告、无追踪 ^[11]。官方导入文档将这一点视为设计初衷：数据应当被永久保存，采用 Markdown 纯文本并本地保存，意味着可以不联网使用，也能随时切换到别的笔记软件 ^[37]。反过来，本地纯文本也让任何第三方工具都能直接操作这些文件 ^[19]。

因此，以记事本打开笔记的设想对笔记本体成立 ^[0,11,37]。插件生成的数据大体上也是文本：看板插件明确把内容存为嵌套的 Markdown 列表，任何编辑器都能读 ^[39]；社区还有 “Txt as md” 这类插件让 Obsidian 直接编辑 .txt/.csv 文件 ^[40]。Dataview 这类动态视图是例外：它”保存后自动生成”的表格是查询渲染出来的结果，数据源（笔记里的 frontmatter）是文本，表格本身却要靠插件渲染出来 ^[0]。

免费的范围：个人免费，商业现在也免费

素材说”个人使用完全免费，只有云同步和在线发布两个付费服务” ^[0]。前半句属实：核心功能全部免费、无功能限制，不需要注册账号 ^[6,11,14]。后半句需要更正：自 2025 年 2 月 20 日起，商用许可（Commercial license）改为可选项，任何人、任何组织都能免费把 Obsidian 用于工作 ^[11,13,14]。商用许可如今相当于自愿赞助，每人每年约 50 美元 ^[5,6,8]，激活它不带来任何功能上的额外好处 ^[7,12]。

需要付费的是两个附加服务：Obsidian Sync（年付约合每月 4–5 美元）和 Obsidian Publish（把笔记发布成网站，年付约合每月 8–10 美元）^[6,8]；另有 Catalyst 单次 25 美元的捐赠档 ^[8,14]。它们都不解锁编辑器内的任何功能 ^[14]。学生、教职员和非营利组织还能申请 Sync/Publish 的 40% 折扣 ^[6,14]。

第一天：下载、建库、认识界面

安装步骤因平台而异：官网下载页提供各平台安装包，macOS 的 .dmg 拖入 Applications 文件夹，Windows 按安装程序引导，Linux 提供 Snap、AppImage 等格式，手机端在 App Store / Play Store 搜 “Obsidian” ^[42,44,0]。首次启动要求”创建新仓库”或”打开已有文件夹” ^[46,49,0]。仓库（Vault）是一个普通文件夹，所有笔记都存在里面 ^[0,49]。界面分三块：左侧文件管理器，中间编辑器（支持”实时预览”，输入 Markdown 符号时立刻渲染格式），右侧默认显示反向链接和大纲 ^[42,0]。Ctrl/Cmd + P 命令面板可搜索任何操作，适合新手先记 ^[42,0]。界面默认英文，改中文路径为设置 → About → Language 选”简体中文” → Relaunch 重启 ^[42,0]。

四个核心概念：仓库、Markdown、双向链接、插件

仓库：一个文件夹，新手先用一个，别同时建多个 ^[0]。Markdown：用纯文字标记格式，例如”#“加空格是标题 ^[0]；实时预览模式下几乎感觉不到在写标记 ^[42,0]。双向链接：在笔记 A 里写 [[B]]，B 变成可点击链接；打开 B 时右侧显示反向链接，提示 A 引用了它 ^[0]。链接把孤立笔记织成网，笔记越多网越有价值 ^[0]。插件：核心插件由官方团队开发和维护，内置于应用 ^[2,18]，在设置里开关 ^[0]；社区插件由第三方开发者维护，通过插件市场发布 ^[18,0]。新手第一天别碰社区插件 ^[0]。

组织方法：MOC、PARA 与 Zettelkasten

整理时文件夹保持在浅层（不超过一两级），主要靠链接和标签组织，不必花几小时设计完美分类——没写过几篇笔记就设计分类容易失败 ^[0]。三种方法论按需选用：

MOC（内容地图）：建立一篇”目录笔记”，把同主题笔记按结构列出，适合做主题入口；还可建 Home 笔记列出所有 MOC，形成”地图的地图” ^[0]。

PARA：按用途分四类——Projects（正在推进、有终点的事）、Areas（长期负责、没有终点）、Resources（兴趣素材库）、Archives（已结束、不活跃）；迁移旧工具时，把旧笔记先全部放进 Archives，桌面干净而历史保留 ^[0]。

Zettelkasten（卡片盒）：卡片盒笔记法在数字时代的实践 ^[6]，核心三条——每篇只写一个想法、用自己的话重新表达、主动建立链接；它不是分类法，是写作法，适合经常写作、做研究的人 ^[0]。

选择方法：想看主题结构用 MOC，按”正在做什么”组织用 PARA，沉淀写作素材用 Zettelkasten；最稳妥的做法是先写半个月，观察哪种需求自然出现 ^[0]。

插件的信任模型：官方审核不是万能保险

插件是 Obsidian 的特性之一，素材在 FAQ 中称”开源，官方有基本审核，绝大多数安全” ^[0]。这一说法需要修正，因为插件机制决定了扩展能力和安全边界。

官方默认开启”受限模式”，不运行任何第三方插件 ^[18,22,25]。文档说明，由于框架的技术原因，官方无法把插件限制到细粒度权限，插件继承 Obsidian 自身的访问级别——可以访问电脑上的文件、连接互联网，甚至安装额外的程序 ^[18,22]。官方审核是”自动扫描每一个插件版本的安全漏洞、代码质量和恶意代码，并给出安全评分卡；对热门、精选和被标记的插件再做人工审查” ^[25]——而不是逐个人工担保，官方承认目前没有精力人工审查每个插件 ^[18]。

审核之外还有两个盲区。插件通过审核后，作者可以随时推送新版本，而插件普遍压缩和转译，安装的构建代码未必与公布的源码一致，普通用户很难核对 ^[24]。此外，这不是理论风险：已有恶意 Obsidian 插件被用来投放远控木马（PHANTOMPULSE RAT），攻击者借”社区插件生态”而非软件漏洞，在金融、加密货币领域定向投递 ^[26,23]。像 Shell Commands 这类插件本身就允许从 Obsidian 执行系统命令，作者在 README 里警告用户别粘贴看不懂的命令 ^[22]。

素材”只装下载量大、评价好、更新频繁的插件”的建议可以参考，但需要更准确的理解：装一个社区插件，本质上是把仓库甚至电脑的一部分访问权交给第三方作者 ^[0,18,22]。实际做法有三步：先从官方市场按需安装（遵循素材的原则”先遇到问题，再找插件解决”）^[0]；安装前查看插件页的下载量 ^[3,4] 和安全评分卡 ^[25]；从镜像站手动下载时核对文件哈希 ^[16]。

顺带说明”插件市场打不开”：Obsidian 插件托管在 GitHub，国内访问不稳定 ^[16,0]。素材提到的 PKMer 是国内社区爱好者自建的插件/主题市场，并非官方，但会与官方插件列表同步，免费注册用户每月约 100 次下载额度，且完全开源、支持哈希比对 ^[15,17,20]。

从日历到数据视图：十个插件的安装顺序

素材按”用一两周再逐步装”的节奏给了十个插件，安装路径统一：设置 → 社区插件 → 关闭受限模式 → 浏览市场 → 搜索 → 安装 → 启用（很多人忘了最后一步，以为插件坏了）^[0]。

第一批（立刻装）：Calendar 在右侧栏加月历，点日期跳转/创建当天日记，配合核心插件”日记”使用 ^[0]；Templater 是高级模板，能自动填入日期、标题、星期几甚至弹出选择框 ^[0]；Image Toolkit 让图片全屏预览、滚轮缩放、拖拽移动，装完即用 ^[0]。

第二批（用一周后装）：Tasks 用查询语法把散在各笔记的任务汇总到一张视图，支持截止日期、计划日期 ^[0]；QuickAdd 绑一个快捷键就能弹出输入框，把灵感追加到指定笔记 ^[0]；Periodic Notes 补上周记、月记、季记、年记，周记文件名默认格式是 gggg-[W]WW（ISO 周年份加周数）^[27,0]，配合 Calendar 可以在日历上直接点周数创建周记 ^[0]。

第三批（用两周后装）：Kanban 在笔记里建看板，卡片内容写 [[笔记标题]] 即可跳转对应笔记 ^[0]；Dataview 把笔记当数据库查询，配合 frontmatter 自动生成读书表格并随新增自动更新 ^[0]；Excalidraw 是手绘风白板，图形里的文字也能含双链 ^[0]；Various Complements 按仓库已有标题做输入补全，笔记上百后最好用 ^[0]。

素材列的这十个里，Calendar、Templater、QuickAdd、Dataview 也出现在资深用户”离不开的 10 款”清单里 ^[1]。顺序本身不重要，重要的是别装太多——装二三十个插件会让启动变慢、界面变复杂，大部分用不上；插件是为”写”服务的，不是让工具支配你 ^[0]。

导入旧资料、接入 AI、同步备份

导入：官方迁移助手（Importer）支持 Notion、Evernote、Bear、Google Keep、OneNote 等主流工具 ^[37]，该插件由 Obsidian 团队维护 ^[2]。少量 Word 文档可以直接全选复制粘贴，标题、加粗、列表会自动转成 Markdown ^[0]；飞书文档导出时优先选 Markdown，直接拖进仓库 ^[0]；PDF 和图片作为附件拖入编辑区即可 ^[0]；音频支持 mp3/wav/m4a，视频支持 mp4/webm，用 ![[文件名]] 嵌入后阅读模式会出现播放器 ^[0]。

接入 AI：素材的方案是装 Copilot 插件，再配置三个要素——API Key（厂商识别并计费的”钥匙”）、Base URL（服务地址）、Model Name（具体模型）^[0]。以 DeepSeek 为例：注册后在控制台创建 API Key，在 Copilot 里添加 Custom Model 填这三项，再把默认模型切过去 ^[0]。DeepSeek 提供官方 API 接入文档 ^[54]，模型有 V3.1、R1 等 ^[52]；素材称其”价格极便宜、注册送免费额度、不需要科学上网”，配置前应以官方页面为准 ^[0]。

同步备份：最省心的是官方 Obsidian Sync——端到端加密、跨设备同步、有版本历史 ^[0,6,8]，价格见上文 ^[6,8]；第三方云盘（坚果云、iCloud 等）把仓库放进同步目录也能用，只是少了端到端加密和版本历史，且 iCloud 仅限苹果生态 ^[0,6]；技术向的方案是 Obsidian Git 插件加私有仓库，免费且有完整版本历史 ^[0]；Syncthing 完全免费、开源、点对点 ^[0]。无论用哪种，至少保留一份独立本地备份，比如每周 rsync 到外置硬盘——本地文件丢了就真丢了 ^[0]。

新手节奏：先写起来

素材给出 5 条建议：先写再整理，别先花两小时设计文件夹分类；不追求完美笔记，一行字也值得记，笔记是给自己用的；养成链接习惯，想到”这跟之前什么有关”就顺手 [[]]；新手期别装太多插件，先裸用一两周；不要把 Obsidian 当收藏夹，原封不动复制粘贴等于零，用自己的话重新表达才有价值 ^[0]。

FAQ 中最需要记住的是数据安全：笔记是本地明文文件，软件公司倒闭也丢不了，但本地文件丢了就真丢了，备份只能靠自己 ^[0,37]。Obsidian 的价值随时间累积——一周写 10 篇可能没感觉，坚持一个月、三个月，它才会变成真正属于你的”第二大脑” ^[0]。

原文更正：素材称只有云同步和在线发布两个付费服务，实际自 2025 年 2 月 20 日起商用许可已改为可选项，商业用途同样免费。 ^[11]