入土式分享Obsidian使用方法

1. 笔记工具选型1.1. 笔记工具汇总笔记工具没有绝对的“最好”核心取决于数据是否需要长期本地保存、是否要多人实时协作以及是否依赖任务、白板或数据库。下面按常见使用方式汇总。1.1.1. VSCodeVSCode 可以直接编辑 Markdown 文件并通过 Git 管理版本配合 Markdown All in One、Foam、Dendron 等扩展可获得预览、目录、双链和知识库能力。适合开发者的技术笔记、与代码同库管理的项目文档。注意它本质上是编辑器日常知识管理的开箱即用体验不如专用笔记软件。1_1VSCode笔记工具效果图1.1.2. NotionNotion 以“页面 块 数据库”为核心可将文档、看板、日历和项目管理放在同一工作区并支持模板与多人协作。适合团队 Wiki、项目管理、内容运营和结构化资料库。注意以云端服务为主复杂数据库设计需要一定学习成本离线与超大知识库体验需实际试用。Notion 产品工作区示意图1.1.3. OfficeOneNoteOneNote 是 Microsoft 365 生态中的数字笔记本支持分区、自由画布、图片、录音、手写和共享协作并可与 Outlook、Teams 等工具配合。适合会议记录、课堂手写笔记以及已使用 Microsoft 365 的个人和团队。注意自由画布很灵活但对 Markdown、双链和可迁移的纯文本工作流支持较弱。1.1.4. SiYuan思源笔记SiYuan是本地优先的块编辑器提供双向链接、块引用、SQL 查询、数据库和多端同步/自托管能力。适合希望兼顾中文体验、块级引用、离线数据与自建同步的个人知识库用户。注意功能面较广初次配置和理解其数据模型需要时间。思源笔记界面示意图1.1.5. TyporaTypora 是所见即所得的 Markdown 编辑器写作时隐藏语法标记并可直接插入图片、表格、公式和代码块。适合写单篇文章、技术文档、课程讲义和需要导出 PDF/Word 的 Markdown 写作。注意它不是完整的知识库系统笔记之间的双链、检索和任务管理需要借助文件组织或其他工具。Typora1.1.6. 印象笔记印象笔记Evernote以剪藏、搜索、标签、扫描和跨端同步见长适合将网页资料、图片和零散记录快速汇集。适合网页剪藏、移动端随手记、票据/图片归档。注意长期知识库需关注订阅方案、导出能力与数据迁移成本建议定期备份重要笔记。1.1.7. 语雀语雀面向中文用户提供知识库、文档协同、团队空间和内容发布能力文档组织方式接近在线 Wiki。适合中文团队文档、产品文档、公开知识库与对外内容发布。注意主要依赖在线工作区若要长期本地归档应建立导出和备份流程。1.1.8. ObsidianObsidian 将笔记保存为本地 Markdown 文件支持双向链接、关系图谱、Canvas、插件和主题。它特别适合逐步沉淀可长期保存的个人知识库。适合个人知识管理、读书笔记、技术笔记、研究和写作。注意高自由度意味着需要自行设计目录、标签、同步与备份规范多人实时协作不是其核心能力。Obsidian 知识库界面示意图1.1.9. LogseqLogseq 是本地优先、以块级大纲和每日笔记为中心的知识管理工具提供双链、任务、查询、闪卡、PDF 标注和白板。适合日记式记录、学习复盘、任务管理和渐进式整理。注意以大纲/块为中心的编辑方式与传统文档不同适应成本较高同步方案应先验证稳定性。Logseq 界面示意图1.1.10. JoplinJoplin 是开源的 Markdown 笔记和待办工具支持端到端加密并可通过 WebDAV、Dropbox、OneDrive 等方式同步。适合重视开源、加密和跨平台同步的个人用户。注意界面与插件生态相对朴素知识图谱和块级引用不是其强项。1.1.11. AppFlowy / AFFiNEAppFlowy 与 AFFiNE 都是偏 Notion 工作区形态的开源选择提供文档、数据库或白板等能力并强调数据控制与自托管可能性。适合想要 Notion 式协作体验、同时在意开源或私有部署的个人和团队。注意功能成熟度、移动端、同步和第三方集成应按实际版本试用评估。1.2. 笔记工具横向比对序号名称官网地址特点优势劣势1VSCode官网编辑器 Markdown Git与代码和版本控制无缝结合扩展丰富文件完全本地化不是专用笔记工具移动端和协作体验较弱2Notion官网页面、数据库、模板、协作数据库和模板强协作与分享方便上手直观主要依赖云端复杂页面可能变慢数据迁移需规划3OneNote官网自由画布、手写、Office 集成手写/录音/图片笔记优秀适配 Microsoft 365Markdown、双链和开放文件格式支持较弱4思源笔记SiYuan官网本地优先、块引用、双链、数据库中文体验好数据控制较强可自托管配置项与概念较多部分完整能力依赖增值服务5Typora官网所见即所得 Markdown 编辑写作流畅Markdown、公式和导出友好不含完整知识库、双链和协作能力6印象笔记官网剪藏、扫描、标签、同步网页/图片资料收集方便跨端成熟长期使用需关注订阅和导出结构化知识管理较弱7语雀官网在线知识库、文档协作、发布中文协作和知识库组织成熟对外分享方便云端依赖较强本地优先工作流较弱8Obsidian官网本地 Markdown、双链、插件、Canvas文件可迁移生态强适合长期个人知识库需要自建方法论、同步和备份实时协作较弱9Logseq官网块级大纲、每日笔记、任务、闪卡记录—关联—复盘一体本地数据学习场景强大纲式写作有学习成本复杂长文排版一般10Joplin官网开源 Markdown、加密、第三方同步开源免费端到端加密同步选择多界面较朴素图谱和块引用能力有限11AppFlowy官网开源工作区、文档、数据库、可自托管数据控制强接近 Notion 使用方式生态和成熟度仍需按版本评估12AFFiNE官网开源工作区、文档、白板文档与白板结合支持本地优先思路部分高级协作能力仍在迭代兼容性须试用选型建议个人长期知识库优先考虑 Obsidian、Logseq 或思源笔记团队协作优先按既有生态选择 Notion、语雀、飞书或 OneNote无论使用哪种工具都应把“同步”和“备份”当作两件独立的事。1.3. Obsidian1.3.1. 简介Obsidian 是一款以本地 Markdown 文件为核心的知识管理与笔记软件。每篇笔记都是普通的.md文件图片和附件也可保存在同一个 Vault库目录中即使未来不再使用 Obsidian仍可通过其他 Markdown 编辑器直接打开和迁移这些内容。它尤其适合将零散的读书摘录、技术资料、项目记录和个人思考逐步连接成个人知识库。Obsidian 不强制固定的目录或标签方法用户可以从简单文件夹开始再按需要加入标签、双向链接、属性和查询。1.3.2. 官方地址官网https://obsidian.md/下载https://obsidian.md/download官方帮助文档https://help.obsidian.md/社区插件https://obsidian.md/plugins主题市场https://obsidian.md/themes1.3.3. Obsidian 工具特性特性说明典型用途本地 Markdown笔记以开放的 Markdown 文件保存在本地 Vault 中长期归档、Git 管理、跨工具迁移双向链接与反向链接使用[[笔记名称]]建立链接并查看哪些笔记引用当前内容关联概念、沉淀知识网络图谱视图将笔记和链接可视化为关系网络浏览主题关联、发现孤立笔记Canvas在无限画布上组合笔记、图片、网页和连线梳理方案、做思维导图或项目规划属性与 Bases为笔记维护标签、日期、状态等属性并以表格等方式聚合浏览阅读清单、项目清单、资料台账全文搜索与嵌入快速搜索 Vault 内容并可将笔记或标题片段嵌入其他笔记汇总页面、专题索引插件与主题核心插件提供基础能力社区插件扩展任务、日历、查询、绘图等功能按个人工作流定制工具多端与同步支持桌面端和移动端可使用 Obsidian Sync 或自行选择同步方案在电脑和手机间访问笔记发布可通过 Obsidian Publish 将选定笔记发布为网站对外分享文档或搭建公开知识库使用建议初期只需建立少量文件夹例如“收集箱、项目、领域、归档”并养成使用[[双向链接]]的习惯。等笔记积累后再按真实需求引入 Dataview、Tasks、日历等社区插件同步前先确认备份策略避免把同步误当成备份。2. 详细使用Obsidian2.1. 下载安装下载地址Download - Obsidian2_1Obsidian安装下载2.1.1. 打开Obsidian2_2打开Obsidian找一个你要写笔记的文件夹创建一个仓库这个仓库就是文件夹的意思2_3Obsidian新仓库2.1.2. Obsidian的功能2_4Obsidian功能介绍2.1.3. 说句实话其实如果你还没有使用过Obsidian那么我就建议你看到这里就行了因为笔记工具就是让你写笔记的而不是让你玩让你折腾笔记工具的等你养成的写笔记的习惯之后我们再向下看Obsidian的其他功能2.1.4. Obsidian的Markdown语法Obsidian 以标准 Markdown 为基础并增加了双向链接、嵌入、Callout、标签和属性等能力。下面先集中展示常用写法再展示它们在阅读视图中的效果。2.1.4.1. 语法总览--- aliases:[Obsidian, 黑曜石]tags:[笔记工具, 知识管理]status: 进行中 created:2026-07-17 ---# 一级标题## 二级标题### 三级标题#标签#项目/Obsidian[[Obsidian]][[Obsidian#工具特性]][[Obsidian|点击查看 Obsidian 介绍]]**粗体**、*斜体*、~~删除线~~、高亮、行内代码- 无序列表 - 二级列表1. 有序列表 -[]未完成任务 -[x]已完成任务引用内容可以有多行[!note]提示标题这是 Obsidian 的 Callout提示块。[Obsidian 官网](https://obsidian.md/)---|名称|类型|状态||---|---|---||Obsidian|笔记工具|使用中|[^1]: 这是脚注内容。 正文中的脚注引用[^1]。 %% 这是一条仅在编辑模式可见的注释 %%2.1.4.2. 展示效果2_5Obsidian特有的Markdown语法2.1.4.3. tip标记汇总[!tip]是 Callout提示块的类型标识并非固定只能使用tip。Obsidian 内置支持以下类型写法中的类型名不区分大小写。类型写法常用别名适合表达[!note]—普通说明、笔记[!abstract]summary、tldr摘要、结论速览[!info]—信息补充、背景说明[!todo]—待办、后续行动[!tip]hint、important提示、经验、重要提醒[!success]check、done完成、成功结果[!question]help、faq问题、帮助、常见问答[!warning]caution、attention注意事项、风险提醒[!failure]fail、missing失败、缺失内容[!danger]error严重风险、错误[!bug]—缺陷、已知问题[!example]—示例、演示[!quote]cite引用、出处[!tip]自定义标题这是提示块正文支持 **Markdown**、[[双向链接]]和嵌入。[!warning]笔记内容[!abstract]摘要、结论速览[!info]信息补充、背景说明[!todo]待办、后续行动[!tip]提示、经验、重要提醒[!success]完成、成功结果[!question]问题、帮助、常见问答[!failure]失败、缺失内容[!danger]严重风险、错误[!warning]- 默认折叠在类型标识后加-提示块默认折叠加则默认展开且可折叠。[!warning] 默认不折叠 在类型标识后加-提示块默认折叠加则默认展开且可折叠。2_7 标记使用效果汇总展示2.1.5. Obsidian 使用案例2.1.5.1. 锁定、左右分屏和关联标签页2_6Obsidian 使用案例2.1.5.2. 官方核心插件核心插件Core plugins由 Obsidian 官方随应用提供无需从社区市场安装。在设置 → 核心插件中可按需启用启用后部分插件还会在左侧栏、右侧栏或命令面板中增加入口。建议先开启高频功能避免一开始把界面堆得过满。 核心插件与第三方插件核心插件是 Obsidian 自带的基础能力第三方插件由社区开发用来补充自动化、任务管理、数据查询等需求。先熟悉核心插件再按真实工作流选择第三方插件。分类核心插件作用建议快速操作命令面板Command palette通过搜索执行几乎所有命令例如新建笔记、切换视图、插入模板建议开启常用命令可设置快捷键快速操作快速切换Quick switcher用关键字快速打开或创建笔记建议开启可替代频繁在文件夹中查找写作模板Templates将预设文本插入当前笔记建议开启用于会议纪要、读书笔记、日报模板写作每日笔记Daily notes按日期自动创建或打开当天笔记建议开启配合模板形成日记/工作日志写作字数统计Word count显示笔记字数、字符数等统计信息写作、翻译或论文场景可开启关联与检索反向链接Backlinks显示哪些笔记链接到当前笔记建议开启是双向链接知识库的核心入口关联与检索出链Outgoing links显示当前笔记已经链接和可能存在的链接建议开启便于补充关联笔记关联与检索标签列表Tag pane汇总 Vault 内的标签及使用次数使用标签分类时开启关联与检索大纲Outline显示当前笔记的标题目录可快速跳转长文、教程、会议纪要建议开启关联与检索关系图谱Graph view将笔记之间的链接展示为网络图可按需开启适合探索关联而非日常编辑必需功能关联与检索页面预览Page preview悬停在内部链接上即可预览笔记内容建议开启减少频繁打开新标签页关联与检索书签Bookmarks收藏常用笔记、搜索结果和链接建议开启用于固定项目首页和常用索引内容组织白板Canvas在无限画布中摆放笔记、图片、网页与连线梳理方案、做课程规划或项目地图时开启内容组织笔记重组Note composer合并笔记或将当前笔记的一部分拆分为新笔记长文拆分、整理零散笔记时开启内容组织工作区Workspaces保存当前标签页、侧栏和窗格布局多项目并行或左右分屏工作流建议开启内容组织Bases基于笔记属性创建表格、卡片等聚合视图管理项目、书单、资料台账时开启内容组织幻灯片Slides使用 Markdown 标题分隔内容并演示笔记用笔记快速汇报时开启文件管理文件恢复File recovery恢复近期被修改或删除的文件版本建议开启但它不能替代完整备份文件管理唯一笔记创建器Unique note creator用固定命名规则快速新建一篇唯一笔记需要原子笔记或编号笔记时开启文件管理随机笔记Random note随机打开 Vault 中的一篇笔记回顾旧笔记、随机复习时开启阅读与资料网页浏览器Web viewer在 Obsidian 内部打开网页内容查阅资料时可开启重要内容仍应摘录到本地笔记阅读与资料脚注视图Footnotes在侧边栏显示当前笔记的脚注列表论文、长文和引用较多的笔记可开启发布与同步发布Publish将选定笔记发布到 Obsidian Publish 网站需要公开文档站点时开启需要对应服务发布与同步同步Sync使用 Obsidian Sync 在设备间同步 Vault多设备使用时可开启也可选择其他同步方案推荐新手先开启命令面板、快速切换、模板、每日笔记、反向链接、出链、大纲、页面预览、文件恢复和工作区。这样既能覆盖“记录—查找—关联—整理”的主流程又不会让功能过多影响上手。启用步骤打开左下角设置 → 选择“核心插件” → 找到目标插件并打开右侧开关点击插件右侧的齿轮图标可继续配置模板文件夹、每日笔记保存位置、图谱显示方式等选项。2.1.5.2.1. 白板2_7_1核心插件-白板2.1.5.2.2. 大纲2_7_2核心插件-大纲2.1.5.2.3. 关系图谱2_7_3核心插件-关系图谱2.1.5.2.4. 工作区2_7_4核心插件-工作区2.1.5.3. 第三方插件2.1.5.3.1. 打开第三方插件2_8_1第三方插件2.1.5.3.2. Obsidian Better Export PDF2_8_2Obsidian Better Export PDF2.1.5.3.3. 本地Excalidraw2_8_4Excalidraw2.1.5.3.3. 日历Calendar插件2_8_3日历2.1.5.4. 颜值-样式2_9_1样式2.1.5.5. 特别使用技巧2.1.5.5.1. 日记模板日历Calendar2_10_1日记笔记样例2.2. Obsidian文件夹说明打开一个 Obsidian Vault仓库后最容易让新手困惑的就是隐藏文件夹.obsidian。它不是你的笔记正文而是这个 Vault 的“应用配置中心”插件、主题、快捷键、工作区布局、图谱设置等大多保存在这里。ℹ️ 先记住一句话Markdown、图片、PDF 等是你的知识内容.obsidian是 Obsidian 如何使用这些内容的配置。内容和配置最好一起备份但不要把配置文件当普通笔记随便修改或删除。2_11_2Obsidian文件夹结构说明2_11_1Obsidian文件夹说明2.2.1. Vault 根目录里通常有什么一个常见的 Vault 可以理解为下面的结构我的知识库/ ├─ 项目/、领域/、归档/ ← 你自己建立的笔记文件夹 ├─ 截图资源/ ← 图片、PDF、音频等附件 ├─ 一篇笔记.md ← Markdown 笔记正文 └─ .obsidian/ ← Obsidian 的配置目录默认隐藏你真正写下的内容主要是.md文件和附件。即使不使用 Obsidian也可以用其他 Markdown 编辑器打开这些文件而.obsidian目录决定了这个 Vault 在 Obsidian 中显示成什么样、装了哪些插件、快捷键如何工作。2.2.2..obsidian文件夹里最重要的三个目录目录作用是否建议同步 / 备份注意事项plugins/存放第三方插件的程序文件及各插件自己的配置建议同步和备份不同设备 Obsidian 版本差异大时插件可能不兼容升级前最好备份snippets/存放自定义 CSS 代码片段用于调整界面和阅读视图样式按需同步建议备份代码片段可能与主题或 Obsidian 新版本冲突出现界面异常可先关闭排查themes/存放已安装主题文件按需同步建议备份只影响外观不同设备不想使用同一主题时可不同步或分别设置如果你只想同步“知识内容”最关键的是.md和附件如果你希望换电脑后插件、主题、快捷键也保持一致则需要把.obsidian一并同步。2.2.3. 常见 JSON 配置文件说明截图中大部分.json文件都是配置文件。JSON 是一种文本格式Obsidian 和插件用它保存开关、路径、布局、列表和个性化设置。正常使用不需要手动打开或编辑。文件 / 文件类型主要作用是否建议手动修改app.json应用级基础设置例如文件处理、编辑器等部分偏好不建议优先在 Obsidian 设置界面修改appearance.json、appearance-设备标识.json主题、配色、字体等外观设置带设备标识的文件通常用于保存不同设备的外观状态不建议外观异常时可先在设置中恢复默认core-plugins.json哪些官方核心插件处于启用状态不建议直接修改在“设置 → 核心插件”中开关community-plugins.json哪些第三方插件处于启用状态不建议直接修改插件报错时可关闭对应插件排查hotkeys.json自定义快捷键映射不建议在“设置 → 快捷键”中修改templates.json模板文件夹、日期格式等模板相关设置可以通过设置界面调整graph.json关系图谱的筛选、颜色、显示等设置不建议在图谱设置面板调整page-preview.json悬停链接预览相关设置不建议在核心插件设置中调整workspace.json、workspace-设备标识.json当前打开的标签页、左右侧栏和窗格布局带设备标识的文件用于区分不同电脑的工作区状态不建议手动编辑多端同步时最容易产生布局差异core-plugins-migration.json、types.json等版本迁移、内部状态或类型相关信息不要删除或手改遇到异常先备份整个目录再排查插件名.json例如text-generator.json某个第三方插件自己的配置优先在该插件设置页面修改包含 API Key 时尤其注意不要公开上传2.2.4. 同步时到底要不要同步.obsidian这不是“必须同步”或“绝对不能同步”的问题要看你的使用方式使用方式建议一台电脑使用保留.obsidian即可定期随 Vault 一起备份两台电脑希望体验完全一致同步整个.obsidian再确认插件、主题和快捷键在两端都正常电脑 手机 / 平板先同步笔记和附件再逐步测试插件与配置移动端不一定兼容所有桌面插件多人共享一个 Vault优先只共享内容工作区布局、快捷键和个人外观设置容易互相覆盖使用 Git 管理可以提交.obsidian但建议在团队内约定哪些个人布局文件不提交减少冲突⚠️ 最常见的坑workspace.json它记录的是“你上次打开了哪些页面、侧栏放在哪里”。在两台电脑间同步时这类个人布局最容易来回覆盖。出现界面布局混乱不要慌先关闭 Obsidian备份.obsidian再删除或恢复对应的workspace*.jsonObsidian 会重新生成默认布局。2.2.5. 新手应该怎么备份和排错备份时备份整个 Vault。不要只复制 Markdown图片、PDF 和.obsidian都应包含在内。插件或主题升级前先复制.obsidian。这是最便宜也最有效的“后悔药”。出现打不开、白屏或插件报错时不要立刻删库。先把.obsidian改名为.obsidian-backup重新打开 Vault如果能正常打开说明问题多半在配置或插件而不是笔记内容。不要把敏感配置公开提交。某些插件配置可能包含 Token、API Key 或服务地址。公开 GitHub 仓库前应检查插件配置文件必要时加入.gitignore。同步不等于备份。OneDrive、Fast Note Sync、Git 等同步方案都可能把误删同步出去重要 Vault 仍应有独立硬盘、NAS 或压缩包备份。最后记住可以放心整理和迁移 Markdown 笔记与附件处理.obsidian前先复制一份。这样即使插件、主题或布局出了问题你的知识内容也仍然安全。3. Obsidian由本地到云存储同步方案3.1. github管理因为markdown知识库本质上是文件存储所以我们可以采用git管理采用github是比较合适的方案。3_1_1GitHub文件存储共享流程但是这个方案的不足之处是ℹ️ Info文件的新增变化管理响应速度不快需要人为的操作git命令或需要点击特定的按钮才可以实现git管理知识库文件太重日常并不需要diff等操作3_1_2Git管理优势和不足3.2. OneDrive文件共享如果 GitHub 的方式更像“手动提交版本”那么 OneDrive 更像“把整个 Vault 当成普通文件夹持续同步”。Obsidian 的笔记、图片和附件本质上都是本地文件只要 Vault 位于 OneDrive 同步目录中OneDrive 就会负责把文件变化同步到云端以及其他电脑。3_2_1OneDrive文件共享同步流程ℹ️ 一句话理解Obsidian 负责读写本地 Markdown 文件OneDrive 负责同步文件。两者并没有直接集成关系所以同步是否稳定主要取决于文件是否完整下载、网络状态以及是否出现多人或多设备同时修改。3.2.1. 适合什么场景3_2_1_1OneDrive适合什么场景OneDrive 更适合下面这类使用方式主要在 Windows 电脑上写 Obsidian偶尔在另一台电脑继续编辑。不想学习 Git 的commit、push、pull等命令只希望文件改完后自动同步。已经在使用 Microsoft 365 或 OneDrive电脑中也已经安装并登录 OneDrive 客户端。知识库以个人使用为主而不是多人同时编辑同一篇笔记。如果你的核心需求是手机、平板和电脑都要稳定双向同步或者多人同时维护一个 Vault建议先评估 Obsidian Sync 或专门的同步方案OneDrive 在桌面端最省心移动端通常需要额外同步工具才能把 Vault 当作本地文件夹使用。3.2.2. OneDrive 同步 Obsidian 的配置步骤确认 OneDrive 已登录并处于正常同步状态。Windows 任务栏右下角的云朵图标不应显示报错或暂停。在 OneDrive 目录中创建 Vault。例如OneDrive\Obsidian\我的知识库。也可以把已有 Vault 整个复制到该目录再在 Obsidian 中选择“打开文件夹作为仓库”。将整个 Vault 设为“始终保留在此设备上”。在资源管理器中右键 Vault 文件夹选择“始终保留在此设备上”。这样笔记、附件和.obsidian配置都会真实保存在本机而不是只显示一个云端占位符。等待首次上传完成。第一次迁移时不要马上在第二台电脑打开先确认 OneDrive 图标显示同步完成且网页端能看到完整目录和附件。在另一台电脑同步同一个目录。登录同一 OneDrive 账号等待 Vault 下载完成也将该文件夹设置为“始终保留在此设备上”然后在 Obsidian 中打开该文件夹。养成切换设备前的检查习惯。在 A 设备编辑结束后等待 OneDrive 同步完成再到 B 设备打开笔记。尤其是刚编辑完图片、附件或大量笔记时不要立即关机或强行切换网络。⚠️ 最关键的一步不要把正在使用的 Vault 设为“仅联机可用”。OneDrive 的“按需文件”会把未下载文件保留为占位符而 Obsidian 需要稳定访问本地 Markdown、附件和配置。请对整个 Vault 使用“始终保留在此设备上”。3.2.3. 在 Obsidian 中如何使用完成配置后日常使用和普通本地 Vault 没有区别直接新建、编辑、移动笔记即可。OneDrive 会在后台同步.md文件、图片附件以及.obsidian配置目录。建议采用下面这个简单流程在当前电脑打开 Obsidian 并编辑笔记。编辑完成后观察任务栏 OneDrive 图标确认没有“正在同步”提示。在另一台电脑开始编辑前先等待 OneDrive 下载最新变化必要时在资源管理器刷新确认修改时间。不要在两台电脑上同时编辑同一篇笔记如果必须协作先约定“一人编辑、一人查看”。对于.obsidian目录也要有意识主题、插件、快捷键、工作区布局等配置会跟着同步。这样能让多台电脑的体验保持一致但如果不同设备需要不同的窗口布局或插件配置就可能相互覆盖需要在设置中选择性关闭部分同步项或拆分 Vault。3.2.4. 优势与不足3_2_2OneDrive优势与不足维度优势不足 / 风险上手难度基本不需要 Git 知识像使用普通文件夹一样操作初次迁移时仍要理解本地文件、云端文件和同步状态的区别同步体验Windows / macOS 桌面端可在后台自动同步改完文件通常无需手动提交不是严格实时协作网络较慢或文件较多时会有同步延迟多设备多台电脑登录同一账号即可使用同一 Vault切换设备前需要等待同步完成同时编辑容易产生冲突副本附件与图片Markdown、图片、PDF 等普通文件可一起同步大量图片、视频或频繁改动的大附件会拖慢同步、占用云盘空间存储额度纯 Markdown 笔记体积较小5 GB 可满足轻量个人知识库免费 Microsoft 账号只有5 GB云存储该额度与 OneDrive 文件/照片、Outlook.com 附件及 Microsoft 365 应用共享。图片、PDF、录屏等附件很容易占满空间超额后无法继续上传和同步需要清理或升级容量历史恢复OneDrive 提供文件版本和回收站能力可处理部分误删或误改历史能力不等同 Git缺少分支、提交说明、逐行 diff 等开发式版本管理移动端可以通过 OneDrive App 查看或分享文件手机/平板上的 Obsidian 通常不能直接把 OneDrive 当作完整本地 Vault需要额外工具或改用其他同步方案协作可以共享 OneDrive 文件夹给他人不适合同一篇笔记多人同时编辑冲突解决不如在线协作文档直观3.2.5. 常见问题与避坑3_2_3OneDrive常见问题与避坑 不要把同步当备份同步会把“删除”和“错误修改”也同步到其他设备。建议定期把整个 Vault 复制到独立硬盘、NAS 或压缩包中重要知识库最好保留第二份备份。出现冲突副本怎么办先不要急着删除。分别打开原文件和冲突文件确认哪一份内容更新再手动合并并保留最终版本。附件丢失或显示不出来先检查附件文件是否已下载到本地以及笔记中的相对路径是否因为移动文件夹而变化。第二台电脑内容旧检查 OneDrive 是否暂停、是否登录了相同账号、Vault 文件夹是否被选中同步以及文件是否已设为“始终保留在此设备上”。插件突然不一致检查.obsidian/plugins和.obsidian/community-plugins.json是否同步完成不同设备的 Obsidian 版本差距较大时先升级再打开 Vault。如何确认真的同步成功在一台电脑新建一篇测试笔记等待同步完成后到 OneDrive 网页端和另一台电脑分别确认该笔记、内容和附件均已出现。最后记住OneDrive 是“省操作”的文件同步方案Git 是“可追溯”的版本管理方案。对于个人、以电脑写作为主的 Obsidian VaultOneDrive 往往更容易坚持对于需要严谨历史、分支和多人开发式协作的知识库再考虑 Git 更合适。3.3. Fast Note SyncFast Note SyncFNS是 Obsidian 的第三方同步插件。它不是把 Vault 交给 OneDrive 这类通用网盘同步而是由插件持续监听 Vault 内的文件变化再通过Fast Note Sync Service把变更推送到其他设备。说白了OneDrive 更像“文件夹同步”Fast Note Sync 更像“为 Obsidian 设计的实时同步服务”。它支持笔记、附件、历史版本、回收站、配置同步和分享能力代价是需要部署或接入独立服务并自行承担服务可用性和数据安全的责任。3_3_1FastNoteSync同步流程ℹ️ 和 Obsidian Sync 的关系Fast Note Sync 是社区插件及其配套服务不是 Obsidian 官方的 Sync 服务。选择它之前应先确认服务部署位置、账号权限、备份策略和后续维护方式。3.3.1. 适合什么场景3_3_1_1FastNoteSync适合什么场景Fast Note Sync 更适合下面几类用户多端高频写作。电脑、手机、平板之间经常切换希望笔记改完后尽快出现在其他设备上。希望同步过程更自动。不想手动执行 Git 命令也不希望频繁等待网盘扫描整个文件夹。能接受部署和维护服务。愿意使用自建服务器、可信服务商或团队已有的服务环境并能处理账号、网络和升级问题。需要附件、历史与分享。除 Markdown 外还有图片、PDF、音频等附件同时希望可查看历史、恢复删除内容或把笔记分享给他人。有自动化需求。需要通过 REST / MCP 等接口与自己的知识库、AI 工作流或其他系统衔接。不太适合下面的情况只在一台 Windows 电脑写笔记且不想维护任何服务。完全不愿意碰第三方插件、服务器地址、授权信息或故障排查。存放高度敏感资料但尚未确认服务端的访问权限、加密方式与备份位置。 和 3.2 怎么选桌面端轻量个人 Vault优先 OneDrive多端频繁切换、追求更及时同步且愿意维护服务再考虑 Fast Note Sync。3.3.2. 配置与同步流程Fast Note Sync 需要两部分同时准备Obsidian 客户端中的插件以及可用的 Fast Note Sync Service 服务端。先准备服务端。部署或获得一个可访问的 Fast Note Sync Service并确认浏览器可以打开其管理界面。安装插件。在 Obsidian 的“设置 → 第三方插件 → 浏览”中搜索Fast Note Sync安装后启用。创建或导入同步 Vault。在服务端创建 Vault再通过“一键授权”或复制授权配置将该 Vault 绑定到当前 Obsidian。等待首次全量同步。第一次同步会上传 Markdown、附件和必要配置文件较多时不要中途切换账号、关闭网络或在多个设备同时修改。接入第二台设备。在另一台设备安装并启用插件使用同一个服务端和同一个 Vault 授权确认一篇测试笔记和附件都已出现。最后再开启高级能力。历史记录、回收站、配置同步、分享或 API 集成建议逐项测试不要第一次就全部打开。⚠️ 配置同步要谨慎插件支持同步部分 Obsidian 配置但配置同步仍应先在测试 Vault 验证。不同设备的主题、窗口布局、插件版本和路径习惯不同直接覆盖可能带来新的问题。3.3.3. 在 Obsidian 中如何使用日常写笔记时Fast Note Sync 会监听 Vault 内文件的新建、更新和删除并将变化同步给服务端及其他已授权设备。你仍然是在本地编辑 Markdown只是同步机制从“网盘扫描文件夹”换成了“插件主动推送变更”。建议使用下面这套验证流程在电脑 A 新建同步测试.md写入当前时间并插入一张小图片。等待插件显示同步完成后在电脑 B 或手机端打开同一 Vault。检查笔记正文、图片附件和修改时间是否一致。在设备 B 修改不同的一段内容再回到设备 A 确认变更已回来。确认无误后再迁移正式 Vault正式库首次接入前先做完整压缩备份。3.3.4. 优势与不足3_3_2FastNoteSync优势与不足维度优势不足 / 风险同步速度面向 Obsidian 文件变化主动同步多端切换时通常比通用网盘更及时仍依赖网络、服务端负载和附件大小不能承诺绝对实时多端支持可用于桌面端、移动端和网页端的多设备工作流每台设备都要完成插件安装、授权和版本兼容检查附件与历史可同步附件并提供历史记录、回收站等恢复能力大附件会增加上传、下载和存储压力历史保留策略需自行规划配置与分享可同步配置并支持分享、备份、镜像及 API / MCP 集成配置同步存在覆盖风险分享链接和服务端权限必须谨慎管理数据控制可选择自行部署服务掌握服务位置和账号权限自建意味着要负责服务器、域名、HTTPS、升级、监控和备份使用成本不必使用 Git 工作流日常操作更接近“打开即同步”需要第三方插件和独立服务长期成本包括时间、服务器和维护风险3.3.5. 常见问题与避坑3_3_3FastNoteSync常见问题与避坑 首次同步前必须备份无论使用什么同步工具第一次把正式 Vault 接入新服务前都先关闭 Obsidian然后把整个 Vault包含.obsidian目录和附件复制或压缩一份到独立位置。同步不是备份错误删除也可能被同步到所有设备。插件连不上服务端。先检查服务端地址、网络连通性、HTTPS 证书、账号授权是否有效不要一上来就反复重装插件。第二台设备看不到最新笔记。检查两端是否连接到同一个 Vault服务端是否在线并用“新建一篇测试笔记 小附件”定位是笔记、附件还是授权问题。大图片或视频同步很慢。附件越大上传和下载越容易延迟。建议将大视频、安装包等非笔记资产放到独立存储并在插件中设置合理的同步范围或白名单。离线后出现内容冲突。长时间离线的两台设备不要同时编辑同一篇笔记重新联网后先确认自动合并结果再继续写入。关键笔记可采用“一人编辑、一人查看”的约定。配置被覆盖或插件异常。先暂停配置同步保留当前.obsidian目录副本再逐项恢复不要把主题、插件和配置故障误判为笔记数据丢失。担心服务端数据安全。自建时应限制访问、启用 HTTPS、使用强密码并维护服务端备份使用他人服务前先确认数据存储位置、权限模型和退出后的数据导出方式。最后记住Fast Note Sync 解决的是“跨端同步效率”不是“免维护的万无一失备份”。如果你愿意维护服务它可以让多端 Obsidian 的体验更顺如果你只想在两台电脑间简单同步OneDrive 往往更省心。