1. 从零开始：为什么是 Obsidian？

如果你正在寻找一款笔记软件，大概率已经听过 Notion、Roam Research、Logseq 这些名字。但当你点开这篇文章，我猜你更想知道的不是“哪个最好”，而是“Obsidian 到底能为我做什么，以及它凭什么值得我花时间去学习”。作为一个从 Evernote 迁移过来，又深度折腾过 Notion 和 Roam 的长期用户，我可以直接告诉你：Obsidian 的核心魅力，在于它给了你一种前所未有的“掌控感”。这种掌控感，不是指界面有多华丽，而是你的每一份笔记，都实实在在地以纯文本文件（Markdown 格式）的形式，存储在你自己的硬盘里。

这意味着什么？首先， 你的数据永远是你的 。没有厂商锁定的风险，不用担心服务突然关闭或涨价。你可以用任何文本编辑器打开、编辑这些 .md 文件。其次，它带来了极致的 可移植性和互操作性 。你可以用 Git 进行版本管理，用 Dropbox、iCloud、Syncthing 或任何网盘进行同步，甚至可以直接扔进 NAS 做远程备份。最后，也是最具颠覆性的一点： 基于链接的网状知识结构 。Obsidian 不是一个简单的文件夹管理器，它鼓励你通过双链（ [[笔记名]] ）将零散的想法连接起来，最终形成一个属于你个人的、不断生长的知识图谱。

很多人一开始会被它“黑乎乎”的默认界面和看似复杂的社区插件吓退。但我想说，Obsidian 的哲学是“渐进式复杂”。你可以从最简单的 Markdown 记笔记开始，完全不用碰任何插件。当你觉得需要时，再去探索那些能极大提升效率的工具。它既可以是小白随手记录的便签本，也可以是学者构建复杂理论体系的利器，或是开发者管理项目文档的知识库。这种从简到繁的平滑路径，是很多“开箱即用”的软件所不具备的。

所以，这篇教程的目标，不是让你一夜之间成为 Obsidian 大师，而是帮你搭建一个坚实、可靠、可扩展的起点。我们会从最核心的“原子操作”讲起，避开华而不实的炫技，聚焦于那些真正能提升你记录、思考和检索效率的功能。当你掌握了这些基础，再去探索浩瀚的插件生态时，你会清楚地知道你需要什么，而不是被海量选择淹没。

2. 核心工作流搭建：笔记、链接与图谱

安装 Obsidian 非常简单，从官网下载对应系统的安装包即可。虽然有时官网下载速度可能不理想，但这是确保安全、获取最新正式版的唯一途径。安装后，第一步是创建一个“库”。这个“库”本质上就是你本地的一个文件夹，Obsidian 会管理这个文件夹里的所有 Markdown 文件。我建议专门在硬盘上创建一个目录，例如 D:\MyKnowledgeVault 或 ~/Documents/Obsidian ，然后让 Obsidian 将其打开为库。

2.1 编辑你的第一份笔记：理解 Markdown 与双链

打开 Obsidian，你会看到左右两栏。左边是文件列表，中间是编辑区。点击左上角的“新建笔记”，我们开始。

Markdown 是基石 ：Obsidian 使用 Markdown 语法，这是一种轻量级标记语言。你只需要记住几个最常用的符号：

• # 一级标题， ## 二级标题，以此类推。
• - 或 * 加空格，创建无序列表。
• 1. 加空格，创建有序列表。
• **文本** 使文本加粗， *文本* 使文本斜体。
• `代码` 表示行内代码， ```语言 表示代码块。

最关键的是链接。在 Obsidian 中，输入两个方括号 [[ ，就会自动弹出笔记列表供你选择。例如，你有一篇笔记叫“机器学习”，在另一篇笔记“深度学习”中写入 [[机器学习]] ，就创建了一个从“深度学习”指向“机器学习”的链接。点击这个链接，如果“机器学习”笔记已存在，则会跳转；如果不存在，Obsidian 会帮你创建它。这就是“双向链接”的起点：链入和链出。

2.2 组织你的知识：文件夹、标签与 MOC

随着笔记增多，你需要一些组织方式。Obsidian 提供了三种互补的方法：

1. 文件夹 ：最传统的方式，适合按项目、领域进行粗粒度分类。比如 Projects/ 、 Areas/ 、 Resources/ 。不要过度细分，否则会陷入整理焦虑。
2. 标签 ：在笔记任意位置输入 #标签名 ，即可添加标签。标签适合描述笔记的属性或主题，如 #待办 、 #读书笔记 、 #概念 。它比文件夹更灵活，一个笔记可以有多个标签。
3. MOC（Map of Contents） ：这是源自 Zettelkasten 卡片盒笔记法的一个高级概念，但在 Obsidian 中极其实用。你可以创建一篇名为“机器学习 MOC”的笔记，里面不写具体内容，只罗列并链接所有与机器学习相关的笔记，比如：

   # 机器学习 MOC
   ## 基础概念
   - [[监督学习]]
   - [[无监督学习]]
   - [[强化学习]]
   ## 常用算法
   - [[线性回归]]
   - [[决策树]]
   - [[神经网络]]
   ## 学习资源
   - [[《机器学习》周志华读书笔记]]
   

   MOC 就像一个手动维护的目录或仪表盘，它本身也是笔记，可以通过链接被其他 MOC 或笔记引用。当你的知识网络变得复杂时，MOC 是防止“迷失在链接中”的导航仪。

2.3 可视化你的网络：图谱视图与反向链接

当你创建了大量双链后，点击左侧边栏的“打开图谱视图”按钮（像蜘蛛网一样的图标），你会看到所有笔记以节点形式呈现，它们之间的链接就是连线。这个视图非常酷炫，但它的主要价值不在于美观，而在于 发现意外的联系 。你可能突然发现，两篇看似不相关的笔记，通过某个中间节点连接了起来，这常常能激发新的思考。

另一个更实用的功能是“反向链接”面板。在编辑区右侧，默认会有一个面板。当你打开一篇笔记时，这个面板会显示 所有链接到当前笔记的其他笔记 。这是双链“双向”特性的直接体现。例如，在“神经网络”笔记的反向链接面板里，你可能会看到“深度学习 MOC”、“反向传播算法”等笔记都链接了它。这让你能快速了解一个概念被哪些上下文引用。

实操心得 ：不要为了链接而链接。初期，优先链接那些你确实认为有强关联的概念。过度链接会让图谱变得杂乱，失去重点。链接的意义在于服务你的思考，而不是构建一个艺术品。

3. 效率飞跃：必装核心插件与基础配置

Obsidian 的强大，一半来自其核心设计，另一半则来自其活跃的社区插件生态。插件通过“社区插件市场”安装。点击左下角设置按钮 -> 第三方插件 -> 关闭“安全模式” -> 浏览社区插件。

对于新手，我强烈建议只从下面这几个最核心、最稳定的插件开始。它们能解决绝大多数高频痛点，且几乎不影响软件性能。

3.1 编辑增强：Dataview 与 Templater

Dataview ：这是将 Obsidian 从笔记软件升级为轻量级数据库的关键插件。它允许你使用一种类 SQL 的查询语法，动态地从你的笔记中提取和展示信息。例如，你可以在一个笔记里写：

```dataview
TABLE file.ctime AS “创建时间”
FROM #读书笔记
SORT file.ctime DESC
```

这段代码会在渲染时，自动列出所有打了 #读书笔记 标签的笔记，并按创建时间倒序排列。你可以用它来制作动态的书单、任务列表、项目进度看板等。学习 Dataview 需要一点时间，但它的回报是巨大的。

Templater ：Obsidian 自带模板功能，但 Templater 更强大。它可以让你在模板中插入动态内容，比如当前日期、时间、随机数，甚至执行 JavaScript 代码片段。例如，一个日记模板可以自动生成基于日期的标题和固定的日志结构。对于需要重复创建固定格式笔记的场景（如会议记录、周报、读书笔记），它能节省大量时间。

3.2 同步与备份：Git 与 Remotely Save

数据安全是重中之重。虽然你可以手动复制库文件夹，但自动化方案更可靠。

Git ：这是程序员最熟悉也最推荐的版本管理方案。你需要先在电脑上安装 Git。然后在 Obsidian 中安装 “Obsidian Git” 插件并进行配置。配置好后，你可以设置定时自动提交（如每5分钟）、拉取和推送。这样，你的每一次修改都有历史记录，可以随时回滚到任意版本。将库推送到 GitHub、Gitee 或自建的 Git 服务器，就实现了跨设备同步和云端备份。这是最自由、可控的方案。

Remotely Save ：如果你觉得 Git 有门槛，可以使用这个插件。它支持将你的库同步到 Dropbox、OneDrive、Webdav 等常见的云存储服务。配置比 Git 简单，适合追求开箱即用的用户。但请注意，它本质上是文件同步，不是版本管理，误删文件后恢复起来可能不如 Git 方便。

避坑指南 ：无论用哪种同步方案， 强烈建议在初期就设定好，并保持习惯 。我曾因为拖延，导致在电脑崩溃时丢失了几天的思考记录，痛定思痛。对于 Git 方案，新手最容易遇到的问题是 .gitignore 文件配置不当，把缓存文件也同步了，导致库体积暴增。一个基础的 .gitignore 应该忽略 .obsidian/ 目录下的 workspace 、 plugins/ （插件本身可以同步，但插件数据通常很大）等非必要文件。社区有现成的模板可供参考。

3.3 界面与阅读优化：Minimal 主题与 Outliner

主题 ：Obsidian 默认的暗色主题不错，但你可以通过社区主题获得更佳的视觉体验。“Minimal” 主题是下载量最高的主题之一，它设计简洁、高度可定制，并且有许多配套的插件设置和 CSS 片段。更换主题在 “外观” 设置里操作，一键切换，无需重启。

Outliner ：如果你习惯用大纲式思维组织内容（类似 Workflowy 或 Dynalist），这个插件是必备的。它增强了列表的编辑体验，支持用快捷键（如 Ctrl+Shift+Enter）在列表项下快速创建新项，用 Tab/Shift+Tab 缩进和突出，并且移动、折叠列表变得非常流畅。它让 Obsidian 的编辑体验更接近一个专业的大纲编辑器。

4. 进阶场景：当 Obsidian 遇见外部工具

Obsidian 不是孤岛，它与其它工具联动能产生奇妙的化学反应。这里介绍两个最经典的组合。

4.1 学术研究流：Zotero + Obsidian

对于学生和科研工作者，Zotero 是管理文献的利器，而 Obsidian 是整理阅读笔记和写作想法的利器。如何让它们联动？

1. 安装插件 ：在 Obsidian 中安装 “Zotero Integration” 插件。在 Zotero 中安装 “Better BibTeX” 插件（用于生成更稳定的引用键）。
2. 配置连接 ：在 Obsidian 插件设置中，指向你的 Zotero 数据库路径。通常插件能自动检测。
3. 插入文献 ：在 Obsidian 笔记中，通过插件提供的命令（如 Ctrl+P 调出命令面板，搜索 “Zotero”），可以搜索并插入 Zotero 库中的文献引用。插入的格式通常是一个链接，点击可以直接打开 Zotero 中的条目。
4. 管理笔记 ：更好的做法是，为每一篇重要文献在 Obsidian 中创建一篇独立的笔记（如 @作者2023标题 ），详细记录摘要、心得、批判性思考。然后在这篇笔记里，用 Dataview 汇总所有引用过该文献的笔记。这样，你的文献笔记和思想笔记就通过 Obsidian 的双链网络有机整合，写作时思路和引证都清晰无比。

4.2 代码开发流：配合 VSCode/Cursor 与 GitHub

如果你是开发者，Obsidian 可以作为你的项目知识库或第二大脑。

配合编辑器 ：由于笔记是纯 Markdown 文件，你可以用任何你喜欢的编辑器打开，比如 VSCode 或 Cursor。你可以在 Cursor 中编写项目代码，同时旁边打开 Obsidian 库，查阅相关设计文档、API 说明或踩坑记录。有些开发者甚至喜欢在 VSCode 里用 Markdown 插件写 Obsidian 笔记，因为编辑器功能更强大。

使用 Git ：如前所述，用 Git 管理 Obsidian 库是天然契合的。你可以为每个项目创建一个子库，或者用一个总库管理所有技术笔记。通过 Git 历史，你可以追溯一个技术方案是如何逐步演进的。

AI 增强 ：社区已经出现了如 “LLM Wiki”、“Obsidian AI” 等插件，它们利用大语言模型的 API（如 OpenAI、Claude），可以在 Obsidian 内实现智能摘要、问答、文本润色等功能。这为知识处理和创作提供了新的可能性。例如，你可以让 AI 帮你将一段凌乱的想法整理成结构清晰的段落，或者根据笔记内容生成问题来测试自己的理解。

4.3 解决常见痛点：插件推荐

根据你提供的热词，这里针对性推荐一些解决特定问题的插件：

• 恢复上次位置的定位插件 ：“Recent Files” 插件可以增强最近文件列表，但更精准的定位可能需要依赖 Obsidian 自带的 “编辑器位置历史”（在命令面板搜索 “Go back” 或 “Go forward”）。社区插件 “Homepage” 可以设置打开软件时自动跳转到指定笔记或上次位置。
• 编辑模式同时可见源码和渲染结果 ：这是“实时预览”模式。在 Obsidian 设置 -> 编辑器 -> 默认编辑模式中，选择“实时预览”即可。在实时预览模式下，你看到的就是渲染结果，但光标所在段落会以源码形式高亮显示，基本实现了“所见即所得”。
• 代码折叠 ：核心功能已支持。在设置 -> 编辑器 -> 可折叠标题，开启后，标题左侧会出现折叠箭头。
• 插入 Excel ：Obsidian 本身不支持直接编辑 Excel，但可以通过 “Advanced Tables” 插件获得强大的表格编辑体验。若要展示现有 Excel 内容，可以将其导出为 CSV 文件，然后使用 “CSV Editor” 插件在 Obsidian 中以表格形式打开和查看。
• 显示 HTML ：默认情况下，出于安全考虑，Obsidian 不渲染 HTML。如果你信任笔记来源，可以安装 “HTML Reader” 插件来查看 HTML 文件内容。对于在笔记中嵌入 iframe 等高级需求，则需要寻找特定插件或使用自定义 CSS。

5. 个性化定制：CSS 片段与主题调校

当你对基础功能熟悉后，可能会对界面有一些个性化的需求，比如调整字体、颜色、布局等。Obsidian 支持通过 CSS 代码片段进行深度定制。

1. 启用 CSS 片段 ：在设置 -> 外观 -> CSS 片段下方，点击文件夹图标，会打开一个名为 snippets 的文件夹。将你的 .css 文件放进去。
2. 回到设置页面 ，刷新列表，你就能看到刚才放入的 CSS 文件，将其开关打开即可生效。
3. 编写 CSS ：你需要一些基础的 CSS 知识。通常，你可以从社区论坛（如 Obsidian 中文论坛）找到别人分享的漂亮片段。例如，一个简单的片段用来修改编辑器的字体：

   .cm-content {
       font-family: “Segoe UI”, “Microsoft YaHei”, sans-serif;
       font-size: 16px;
   }
   

4. 调试 ：按 Ctrl+Shift+I （Windows/Linux）或 Cmd+Opt+I （Mac）打开开发者工具，使用元素检查器来查看你想修改的界面元素的类名，然后针对性地编写 CSS。

个人体会 ：CSS 定制是一把双刃剑。它能让你的 Obsidian 独一无二，提升使用愉悦感。但过度定制会带来维护成本，尤其是当主题或 Obsidian 版本更新时，可能会导致样式错乱。我的建议是，先从一两个最影响你体验的小改动开始（比如行高、字体），并且尽量使用社区广泛测试过的片段。不要一开始就试图打造一个“完美”的界面，工具的核心是服务于内容生产，而非本末倒置。

Obsidian 的学习曲线后段是平缓而开放的。它的基础，Markdown 和双链，在几小时内就能掌握。而它的深度，由你通过插件和工作流去定义。不要试图一次性装上所有炫酷的插件，那只会让你陷入配置的泥潭。最好的方式是： 遇到一个具体的问题或需求，再去寻找解决它的插件或方法 。让工具适应你，而不是你适应工具。

最终，你会形成一套完全贴合自己思维习惯的知识管理系统。这套系统建在你自己的数据之上，随着时间流逝不断增值，成为你真正的“第二大脑”。这，就是 Obsidian 能带给你的，最核心的价值。