Obsidian 是以本地文件为中心的 Markdown 知识库工具：一个 vault 通常就是设备上的文件夹，笔记以 .md 文件保存，再用双向链接、反向链接、Properties、Bases 和 Canvas 组织成可检索的资料库。它适合希望掌握文件位置、格式和迁移方式的用户，也适合从零搭建长期知识库的人。
截至 2026 年 9 月 6 日，官方变更记录列出的桌面版为 1.14.0，移动端也有独立版本号。核心应用无需注册即可使用；Obsidian Sync、Publish 和商业支持是另外的服务。本文把重点放在“创建本地库—建立链接—选择同步—控制插件风险”的完整路径，不把第三方同步方案写成官方保证。
一、下载、安装与首次创建 Vault
按平台选择官方安装包
官方入口提供 Windows Universal、macOS Universal、Linux AppImage/Snap/Deb/Flatpak，以及 iOS、Android 和 Android APK。Windows 和 macOS 直接运行安装包；Linux 应根据发行版选择包装方式，AppImage 需要赋予执行权限。移动端从应用商店安装更容易获得系统权限和更新提示，APK 则应只从官方下载页进入。
官方下载：https://obsidian.md/download。安装后选择“Create new vault”创建资料库，指定一个真实存在、便于备份的文件夹；已有 Markdown 文件则选择“Open folder as vault”。不要把多个同步软件同时指向同一个库，也不要把整个库放在会自动释放本地文件的按需下载目录中。
二、Markdown、双向链接与结构化属性
先用文件和文件夹建立底层
Obsidian 的基础单位是 Markdown 文件。可以用文件夹表示项目或领域，用标签标记状态，用 Properties 保存日期、类型、来源和完成度。文件名、内部链接和附件路径都属于实际文件结构，迁移前先确认附件是否跟随库一起复制，避免只导出文本却丢失图片和 PDF。
双向链接、反向链接和 Bases
在笔记中输入 [[页面名]] 可建立内部链接；反向链接面板显示哪些笔记指向当前页面，适合整理人物、项目和概念之间的关系。Properties 让字段变得可筛选，Bases 则能把带有相同属性的笔记呈现为表格、列表或卡片。先统一字段名称和日期格式，再建立视图，否则同一含义的字段会被拆成多个筛选条件。
三、Canvas 与 Web Clipper：把资料放进工作流
Canvas 用于发散和重组
Canvas 可以把笔记、网页、图片、PDF 和卡片放在同一画布上，用连线表达关系。它适合做项目地图、阅读框架和问题拆解，但画布布局不能替代笔记正文；完成整理后，应把结论回写到 Markdown 文件，并为引用的资料保留来源。
Web Clipper 需要单独安装和授权
官方 Web Clipper 支持 Chrome、Safari、Firefox、Edge 等浏览器。剪藏前先选择目标 vault 和模板，确认页面标题、正文、标签及图片会保存到哪里。登录状态、网页权限和第三方站点内容可能影响剪藏结果，遇到付费墙或动态页面时不要把“剪到一部分”误认为完整归档。
四、同步方案怎么选，为什么要先备份
官方 Sync、云盘、Syncthing 与 Git 的差异
Obsidian 官方推荐的跨设备方案是 Obsidian Sync：本地仍保留文件，远端 vault 负责同步，并提供端到端加密和版本历史。iCloud 更适合 Apple 设备；官方文档提醒 iCloud Drive on Windows 可能产生重复或损坏。OneDrive、Google Drive、Syncthing 和 Git 都能用于特定平台，但需要自己处理离线文件、冲突和推送/拉取顺序。
同一个 vault 不要同时由 Sync、iCloud、OneDrive 或插件写入。首次启用任何同步前，先关闭 Obsidian，复制整个 vault 到独立备份位置，再在一台设备完成同步并检查链接、附件和配置文件。Git 更适合手动版本管理，不会自动替你解决两个设备同时修改同一段文本的问题。
五、社区插件、主题与安全边界
社区插件会以第三方代码运行。进入 Settings → Community plugins，关闭 Restricted mode 后才能浏览和安装；安装后还要单独 Enable，插件更新也不是完全自动进行。只安装能说明作者、权限和用途的插件，并在启用前备份 vault；遇到启动异常时，先恢复 Restricted mode 或停用最近加入的插件。
官方插件说明：https://obsidian.md/help/Extending%2BObsidian/Community%2Bplugins。插件、主题和 CSS 片段都可能改变界面、读取文件或访问网络，不能因为它们出现在社区目录就推断为官方维护或绝对安全。
六、备份、迁移与适用工作流
- 开始整理前复制整个 vault，并把备份放到不同磁盘或独立存储位置。
- 迁移时优先复制 Markdown、附件和必要的配置文件；不要只导出 HTML 再把它当成可继续编辑的源库。
- 同步出现冲突时先暂停自动同步，保留冲突文件和日志，再逐项合并；不要用一台设备的空库覆盖远端。
- 适合本地文件、长期积累和可迁移性优先的人；如果主要需求是多人实时编辑或开箱即用的云端协作，应比较专门的在线服务。
官方入口
- 官方下载：https://obsidian.md/download
- 官方价格与 Sync/Publish：https://obsidian.md/pricing
- 官方同步说明：https://obsidian.md/help/Getting%2Bstarted/Sync%2Byour%2Bnotes%2Bacross%2Bdevices
- 社区插件说明：https://obsidian.md/help/Extending%2BObsidian/Community%2Bplugins
- 官方更新记录：https://obsidian.md/changelog/
Obsidian 的核心优势是文件可见、格式开放和扩展自由；对应的成本是同步、插件和备份需要自己做选择。下载或升级前以官网当前平台包、更新记录和服务条款为准。
暂无评论内容