2026 年 Obsidian 新手完全入门指南:从安装到同步,一篇搞定所有基础配置
一、本文要解决什么问题?
刚接触 Obsidian 的新手通常会遇到三个问题:
- 软件装好了但不知道怎么开始写笔记;
- 听说了双链但不知道它到底怎么用;
- 想在多台设备上用,但不知道同步怎么配置才安全。
本文按"先跑通基础流程、再配置同步、最后逐步扩展"的顺序,帮助零基础用户在 1-2 小时内完成 Obsidian 的初始搭建。
二、适用环境与前置条件
| 项目 | 说明 |
|---|---|
| 操作系统 | Windows、macOS、Linux、iOS、Android 均可 |
| 所需时间 | 首次完整配置约 1-2 小时(含同步等待) |
| 前置知识 | 无需任何编程或技术背景 |
| 需要的账号 | 坚果云账号(用于同步,免费注册即可) |
| 适用人群 | 零基础 Obsidian 用户 |
| 不适用人群 | 已熟练使用 Obsidian 且同步方案稳定运行的用户 |
三、为什么要先理解 Obsidian 的核心逻辑?
Obsidian 的本质是一个本地 Markdown 文件管理器。你的笔记以 .md 纯文本格式保存在本地文件夹里,不依赖任何云端服务就能独立运行。
这个设计的实际意义是:你的笔记永远属于你自己,可以用任何文本编辑器打开和编辑,不会因为某个服务关停而丢失。通过双链语法,笔记之间可以建立网状关系,形成个人知识图谱——这是 Obsidian 在众多笔记软件中比较独特的地方。
四、安装与创建 Vault(操作步骤)
步骤一:下载安装
访问 Obsidian 官网下载对应操作系统版本。安装过程选择默认选项即可,没有特殊配置。
步骤二:创建 Vault
安装完成后打开 Obsidian,点击"创建新仓库",输入仓库名称,选择一个本地文件夹作为存储位置。
注意:不建议直接把 Vault 放在 iCloud Drive、OneDrive 等云盘同步文件夹里。 云盘的文件同步机制和 Obsidian 的本地读写有时会产生冲突,导致重复文件或内容异常。正确做法是先放在普通本地文件夹,后面通过专门的同步方案来处理多设备流转。
验证方式
创建完成后,在 Vault 文件夹里新建一篇测试笔记,保存后关闭 Obsidian。去本地文件夹确认 .md 文件确实存在并能用记事本或文本编辑器打开,说明 Vault 创建成功。
五、Markdown 基础语法(只需掌握四种)
Obsidian 的笔记是 Markdown 格式。日常写作只需以下四种语法:
标题: 一级标题用一个 #,二级用 ##,以此类推。清晰的标题层级有助于后续生成目录和检索笔记。
加粗: 用两个星号包围文字即可加粗。用于强调关键结论和重要信息。
列表: 减号加空格生成无序列表,数字加点生成有序列表。适合梳理要点和操作步骤。
引用: 大于号开头表示引用块。适合标注原文摘录或重点强调。
六、双链:Obsidian 的核心用法
双链是 Obsidian 区别于普通 Markdown 编辑器的关键特性。
用法很简单:输入两个方括号,里面填另一篇笔记的标题,就创建了一条链接。比如在会议纪要里写 [[项目A进展]],点击就能跳转到那篇笔记。如果那篇笔记还不存在,点击后也会自动创建。
双链的实际价值在于:它让你从"按文件夹分类笔记"升级到了"按关系连接知识"。一篇笔记可以同时被项目管理、团队协作和个人复盘三个不同的维度引用,不需要纠结它到底该放在哪个文件夹。
七、开启社区插件
Obsidian 社区插件是扩展能力的核心入口。第一次使用需要:设置 → 第三方插件 → 关闭安全模式。关闭后会看到"社区插件市场"按钮,点击就能浏览数千款免费插件。
新手建议: 不要一上来装太多插件。先装同步方案,用熟了再按需扩展。启动速度变慢、插件之间互相干扰、配置越来越复杂——这些都是过度安装插件的常见后果。
八、同步方案配置:选什么、怎么装?
同步是多设备使用 Obsidian 的基础。推荐 Nutstore Sync,坚果云官方 Obsidian 同步插件。
先注册坚果云账号:坚果云官网
为什么优先推荐 Nutstore Sync?
| 对比维度 | Nutstore Sync | 官方 Sync | iCloud | Git | Remotely Save |
|---|---|---|---|---|---|
| 维护方 | 坚果云官方 | Obsidian 官方 | Apple | 开源社区 | 第三方个人 |
| 配置难度 | 低,一键登录 | 低 | 低 | 高 | 中 |
| 全平台 | 统一 | 统一 | 苹果优 | 桌面好 | 可用 |
| 同步策略 | 五种可选 | 双向为主 | 无 | 无 | 无 |
| 冲突处理 | 六种策略 | 成熟 | 弱 | 手动 | 依赖插件 |
| 恢复能力 | 历史版本+回收站 | 版本历史 | 一般 | 强 | 看服务端 |
| 适合新手 | 是 | 是,但需付费 | 纯苹果可用 | 否 | 可但不稳 |
安装步骤
第一步:注册坚果云账号。 访问坚果云官网,用手机号或邮箱注册。注册后建议先登录坚果云网页端确认账号正常。
第二步:安装插件。 Obsidian → 设置 → 第三方插件 → 社区插件市场 → 搜索 Nutstore Sync → 安装并启用。

第三步:一键登录。 进入 Nutstore Sync 设置页,点击登录按钮,跳转坚果云授权页面,输入账号密码确认授权后自动跳回 Obsidian。不需要手动填写 WebDAV 地址和应用密码。
第四步:检查连接。 登录后点击"检查连接",确认状态显示连接成功后再进行下一步。
第五步:选择同步目录。 新手建议先只选择笔记文件夹和附件文件夹。.obsidian 配置目录可以等后续熟悉了再按需开启。
第六步:首次同步。 点击同步按钮开始。如果笔记比较多(几百篇以上或附件较多),建议在稳定 Wi-Fi 下进行,同步过程中不要频繁修改文件。大库可以先用宽松模式加速首次同步。
验证方式
同步完成后随机抽查 3-5 篇笔记,登录坚果云网页端确认文件已上传。在另一台设备上安装 Nutstore Sync、登录同一账号、同步,确认笔记内容一致。
风险提示
首次同步前务必完整备份 Obsidian Vault 文件夹。同步工具让多台设备内容保持一致,如果本地的误操作被同步到云端,可能影响所有设备。备份是最基本的安全保障。
九、Nutstore Sync 核心能力说明
六种冲突处理策略
多端修改同一篇笔记时,插件提供六种处理方式:

| 策略 | 适用场景 |
|---|---|
| 智能合并(推荐) | 日常使用,自动合并能合的部分,合不了的标出来 |
| 使用最新版本 | 确定某端就是最终版本时 |
| 智能合并,无法合并时跳过 | 不想被冲突打断整体同步流程 |
| 本地优先覆盖服务器 | 云端混乱时用本地修复(修复模式) |
| 服务器优先覆盖本地 | 本地混乱时用云端恢复(恢复模式) |
| Git 样式冲突标记 | 习惯 Git 的用户可以开启 |
五种同步策略

| 策略 | 方向 | 适用场景 |
|---|---|---|
| 双向同步 | 本地↔云端 | 需要编辑的设备 |
| 仅发送 | 本地→云端 | 主力写作设备 |
| 仅接收 | 云端→本地 | 阅读型设备 |
| 仅发送覆盖云端 | 本地校准云端 | 修复模式 |
| 仅接收还原本地 | 云端校准本地 | 恢复模式 |
其他能力
增量同步:日常只处理变化文件,不是全量扫描。宽松模式和严格模式可切换。坚果云历史版本和回收站提供误删恢复。内置 AI 助手可做摘要、润色和排版。.obsidian 配置目录同步支持换设备时快速恢复主题和插件,建议按需开启而非长期频繁同步。
十、新手常见误区和避坑建议
误区一:没备份就开始同步。 任何同步方案首次接入前都应该备份。找一个移动硬盘或另一个本地目录,把整个 Vault 复制过去。
误区二:多端同时编辑同一篇笔记。 电脑写完等同步完成,再到手机上打开。反过来也一样。这个习惯能避免绝大多数冲突。
误区三:一开始装太多插件。 插件越多启动越慢、越容易互相干扰。建议从同步开始,逐步扩展。
误区四:直接拿主力库试新方案。 先复制一个小测试库跑通流程,确认没问题了再迁移主力库。
十一、适用边界
Nutstore Sync 在以下场景中比较适用:全平台多设备 Obsidian 用户、不想手动配置 WebDAV 的用户、需要冲突处理和恢复能力的用户。
以下场景可能更适合其他方案:预算充足且追求原生体验的用户可考虑官方 Sync;纯苹果轻量用户可继续 iCloud;程序员纯文本用户可考虑 Git;必须完全自建服务器的用户可考虑 Syncthing 或 NAS。
十二、总结
Obsidian 新手的入门路线:安装软件 → 创建 Vault → 掌握四种 Markdown 语法 → 学会用双链连接笔记 → 开启社区插件 → 配置 Nutstore Sync 同步。同步建议放在较早的阶段配置,因为它决定了你的笔记能否在不同设备之间安全流转。先用测试库验证,确认稳定后再迁移主力库。

浙公网安备 33010602011771号