1. 为什么我最终选择了 Obsidian 作为主力笔记工具1.1 从“笔记难民”到“第二大脑”的转变我用过的笔记软件不算少从最早的印象笔记、有道云笔记到后来的 Notion、语雀、飞书文档再到本地优先的思源笔记、Logseq几乎每一款都深度使用过至少三个月。换来换去的核心原因只有一个数据不在自己手里心里不踏实。云笔记一旦停止服务、调整收费策略或者网络出现波动多年积累的笔记就可能变成一堆无法访问的孤岛。而 Obsidian 最打动我的地方就是它把所有的笔记都以纯 Markdown 文件的形式存放在本地文件夹里软件本身只是一个“阅读器”和“编辑器”。哪怕有一天 Obsidian 这个软件不在了我的笔记依然可以用任何文本编辑器打开这种安全感是其他工具很难给的。所谓“第二大脑”说白了就是把你脑子里那些零散的灵感、待办、读书笔记、项目资料、会议记录用一个统一的系统管理起来让它们在需要的时候能被快速检索、关联和复用。Obsidian 通过双向链接和关系图谱这两个核心机制让笔记之间不再是孤立的文件而是像神经元一样互相连接。你写一篇关于“时间管理”的笔记里面提到“番茄工作法”就可以直接链接到另一篇专门讲番茄工作法的笔记久而久之你的知识网络就自然生长出来了。这篇文章适合谁看如果你是第一次接触 Obsidian或者之前下载过但被满屏的英文界面和插件系统劝退那这篇内容就是为你准备的。我会从下载安装、中文界面配置、核心设置、插件推荐、图片管理、同步方案、Git 版本控制这几个维度把整个入坑流程拆解得明明白白。即使你完全没有编程基础跟着步骤走也能搭建出一个可用的知识库。1.2 Obsidian 的核心优势与适用场景Obsidian 的核心优势可以归纳为四点。第一是本地优先所有文件都在你自己的硬盘上不依赖任何云服务。第二是纯文本格式Markdown 是通用标准迁移成本极低。第三是双向链接笔记之间可以建立双向关联形成知识网络。第四是插件生态社区插件数量超过两千个几乎可以定制出任何你想要的功能。适用场景方面Obsidian 特别适合以下几类人需要长期积累知识的研究者、写作者、程序员需要管理大量项目资料的职场人喜欢折腾工具、追求数据自主权的效率爱好者以及需要将笔记与 Zotero 联动管理文献的学术工作者。如果你只是偶尔记几条待办那系统自带的备忘录可能更合适Obsidian 的学习曲线确实需要投入一些时间。2. 下载安装与中文环境配置的完整流程2.1 下载渠道选择与安装包说明Obsidian 的官方下载地址是 obsidian.md打开后根据你的操作系统选择对应的安装包。Windows 用户下载.exe文件macOS 用户下载.dmg文件Linux 用户可以选择.AppImage或.deb包。这里要提醒一句很多朋友反馈“obsidian下载太慢了”这是因为官方服务器在海外国内访问速度确实不稳定。我的建议是优先尝试官方渠道如果速度实在无法接受可以搜索“obsidian下载 镜像”找到国内高校或开源社区维护的镜像站点但一定要注意核对文件哈希值确保安装包没有被篡改。安装过程本身非常简单Windows 下双击.exe一路下一步即可macOS 下把图标拖进 Applications 文件夹就完成了。首次启动时Obsidian 会让你选择“创建新仓库”或“打开已有文件夹作为仓库”。仓库Vault是 Obsidian 的核心概念它本质上就是一个普通的文件夹你所有的笔记、附件、配置都存放在里面。我建议在非系统盘比如 D 盘或移动硬盘创建一个专门的文件夹命名为MyVault或SecondBrain路径中尽量不要包含中文和空格避免后续使用 Git 或同步工具时出现编码问题。2.2 中文界面设置与基础偏好调整Obsidian 默认是英文界面对于英文不太熟悉的朋友第一步就是切换成中文。点击左下角的齿轮图标进入设置找到About页面在Language下拉菜单中选择“简体中文”然后重启软件即可。重启后整个界面就变成中文了包括设置项、菜单和提示信息。接下来有几个基础设置建议你顺手调整。在“编辑器”设置中把“默认编辑模式”改为“实时预览”这样你在编辑时就能直接看到 Markdown 渲染后的效果不用频繁切换预览模式。在“文件与链接”设置中把“新建链接格式”改为“相对路径”这样即使你以后移动仓库文件夹链接也不会失效。另外建议开启“自动更新内部链接”当你重命名一篇笔记时所有指向它的链接会自动更新这个功能能省掉大量手动修改的麻烦。还有一个容易被忽略的设置是“附件默认存放路径”。Obsidian 默认把粘贴的图片放在仓库根目录时间一长根目录就会变得非常混乱。我建议在设置中把附件路径改为attachments文件夹并开启“自动创建文件夹”选项。这样所有粘贴的图片都会自动归集到attachments目录下仓库结构会清爽很多。2.3 仓库目录结构设计建议仓库的目录结构没有标准答案但根据我自己的使用经验一个清晰的初始结构能让你少走很多弯路。我目前的仓库顶层目录是这样的MyVault/ ├── 00-Inbox/ # 收集箱临时存放未整理的笔记 ├── 01-Daily/ # 日记按日期命名 ├── 02-Notes/ # 永久笔记经过整理的知识点 ├── 03-Projects/ # 项目资料按项目名称建子文件夹 ├── 04-Areas/ # 领域笔记如健康、财务、职业发展 ├── 05-Resources/ # 参考资料如读书笔记、课程笔记 ├── 06-Archive/ # 归档已完成或不再活跃的内容 ├── attachments/ # 所有图片和附件 ├── templates/ # 模板文件 └── .obsidian/ # 软件配置不要手动修改这个结构参考了 PARA 方法Projects、Areas、Resources、Archive但做了一些简化。核心思路是先收集后整理。所有新笔记先扔进00-Inbox每天或每周固定时间整理一次把有价值的笔记移到对应目录没价值的直接删除。这样能避免“整理瘫痪”——很多人一开始就想建立完美的分类体系结果花在分类上的时间比写笔记还多。3. 核心功能配置与插件生态搭建3.1 双向链接与关系图谱的实战用法双向链接是 Obsidian 的灵魂功能。在笔记中输入[[就会弹出搜索框输入关键词就能链接到已有笔记如果笔记不存在回车就会创建一篇新笔记。比如我在写这篇教程时输入[[obsidian插件推荐]]就会自动生成一篇同名笔记的链接。点击这个链接就能跳转过去而在那篇笔记的“反向链接”面板中会自动显示所有引用了它的笔记。关系图谱Graph View则是双向链接的可视化呈现。点击左侧边栏的图谱图标你就能看到所有笔记以节点形式展示链接关系以连线形式呈现。节点越大说明这篇笔记被引用的次数越多。我习惯每周看一次图谱那些孤立的节点没有任何连线的笔记就是需要处理的对象——要么把它们链接到相关笔记要么直接删除。这里分享一个实操技巧用 MOCMap of Content组织主题。MOC 就是一篇索引笔记里面用链接列出某个主题下的所有相关笔记。比如我有一篇[[Obsidian使用手册]]的 MOC里面链接了安装配置、插件推荐、同步方案、Git 使用等所有相关笔记。这样我只需要记住 MOC 的位置就能快速找到所有相关内容比依赖文件夹层级高效得多。3.2 必装插件清单与配置要点Obsidian 的社区插件是它强大的关键但插件装太多也会拖慢启动速度。以下是我筛选出的必装清单按优先级排序插件名称核心功能配置要点Templater高级模板支持变量和脚本设置模板文件夹路径开启“触发时自动跳转”Dataview用类 SQL 语法查询笔记需要学习基础语法建议从简单查询开始Calendar日历视图快速打开日记配合日记功能使用设置每周起始日Obsidian Git自动备份到 Git 仓库需要先安装 Git配置仓库路径和自动提交间隔Advanced Tables表格编辑增强开启“自动格式化表格”Image Toolkit图片查看增强支持缩放、旋转、复制图片Charts View在笔记中渲染图表支持折线图、柱状图、饼图等Homepage设置启动时打开的笔记指定一篇笔记作为主页安装方法很简单设置 → 第三方插件 → 关闭“安全模式” → 浏览社区插件 → 搜索插件名称 → 安装 → 启用。这里要注意安装插件时需要网络连接如果社区插件页面加载不出来可以尝试在设置中配置代理或者手动下载插件文件放入.obsidian/plugins目录。关于obsidian chartsview这个插件它允许你在笔记中直接写代码块来渲染图表对于需要做数据可视化的朋友非常实用。比如你可以用它在日记中绘制每周心情变化曲线或者在项目笔记中展示进度甘特图。配置时需要在插件设置中开启对应的代码块语言支持。3.3 主题美化与阅读体验优化Obsidian 默认主题比较朴素但社区提供了大量精美主题。我目前用的是 Minimal 主题它的特点是界面干净、字体渲染清晰、支持多种配色方案。切换主题的方法设置 → 外观 → 主题 → 管理 → 浏览社区主题 → 搜索主题名称 → 安装并使用。除了主题字体设置也很关键。我建议正文使用“霞鹜文楷”或“思源宋体”这两款中文字体在屏幕上的阅读体验都很好。在“外观”设置中可以分别设置界面字体、正文字体和代码字体。正文字号建议设为 16px 到 18px行高设为 1.6 到 1.8这样长时间阅读不容易疲劳。另外一个小技巧开启“聚焦模式”和“打字机模式”。聚焦模式会高亮当前编辑的段落其他内容变暗打字机模式会让光标始终保持在屏幕中央。这两个功能在写长文时特别有用能让你专注于当前正在写的内容减少视觉干扰。4. 图片管理、同步方案与 Git 版本控制4.1 图片管理的最佳实践obsidian图片管理是很多新手容易踩坑的地方。默认情况下你粘贴一张图片Obsidian 会在仓库根目录生成一个类似Pasted image 20260101120000.png的文件。如果不加管理几个月后根目录就会堆满几百张图片找起来非常痛苦。我的解决方案是结合两个插件Image Auto Upload和Local Images。前者可以把图片自动上传到图床比如 PicGo 支持的图床后者可以把网络图片下载到本地。但如果你不想折腾图床最简单的方案还是前面提到的在设置中把附件路径固定为attachments文件夹并开启“自动创建文件夹”。更进一步我建议按月份建立子文件夹比如attachments/2026-01/、attachments/2026-02/。这需要配合 Templater 插件实现在模板中写入动态路径变量。这样图片会按时间自动归档既不会全部堆在一起也不会因为文件夹太多而难以查找。还有一个细节Obsidian 支持在链接中指定图片显示尺寸。语法是![[图片名.png|300]]其中300是宽度像素值。这个技巧在插入截图时特别有用可以避免图片过大撑破版面。4.2 多设备同步方案对比与选择obsidian同步是另一个高频问题。Obsidian 本身不提供同步服务官方同步服务需要付费所以需要自己解决。目前主流的方案有四种方案优点缺点适合人群官方同步开箱即用端到端加密收费按年订阅预算充足、追求省心第三方网盘免费或低成本可能产生冲突文件有网盘会员的用户Git 同步版本控制可回溯需要学习 Git移动端体验一般程序员、技术爱好者自建同步服务完全可控需要服务器和运维知识有技术背景的用户我目前用的是 Git 方案配合obsidian git插件实现自动提交和推送。具体配置先安装 GitWindows 下载 Git for WindowsmacOS 用 Homebrew 安装然后在仓库目录执行git init关联远程仓库GitHub、Gitee 或自建 Git 服务都可以。在 Obsidian Git 插件设置中开启“自动备份”设置间隔为 30 分钟开启“启动时拉取”和“关闭时推送”。这里有个坑要注意不要用 Git 同步.obsidian/workspace.json文件这个文件记录的是当前打开的标签页和面板布局不同设备之间同步会导致界面混乱。在.gitignore文件中加入.obsidian/workspace.json和.obsidian/workspace-mobile.json即可。4.3 Git 版本控制实操步骤对于不熟悉 Git 的朋友我把完整流程拆解一下。首先安装 GitWindows 用户下载安装包后一路下一步安装完成后在开始菜单找到“Git Bash”打开。macOS 用户在终端输入git --version如果没有安装会提示你安装 Xcode Command Line Tools按照提示操作即可。安装完成后配置用户名和邮箱git config --global user.name 你的名字 git config --global user.email 你的邮箱然后进入你的 Obsidian 仓库目录cd /path/to/MyVault git init git add . git commit -m 初始化仓库接下来在 GitHub 或 Gitee 上创建一个空仓库获取仓库地址然后关联git remote add origin https://github.com/你的用户名/仓库名.git git push -u origin main如果推送时提示需要认证GitHub 现在要求使用 Personal Access Token 而不是密码。在 GitHub 设置 → Developer settings → Personal access tokens 中生成一个 token勾选repo权限然后用这个 token 作为密码即可。配置完成后回到 Obsidian安装并启用 Obsidian Git 插件。在插件设置中把“自动备份间隔”设为 30 分钟“提交信息”可以自定义比如vault backup: {{date}}。开启“启动时拉取”和“关闭时推送”这样每次打开和关闭 Obsidian 时都会自动同步。5. 常见问题排查与避坑经验实录5.1 安装与启动阶段的典型问题问题一下载速度极慢或无法下载。这是最常见的问题原因是官方服务器在海外。解决方案尝试在非高峰时段下载或者搜索国内镜像站点。如果使用镜像务必核对文件大小和哈希值。问题二安装后打开提示“无法访问此文件夹”。通常是因为仓库路径包含特殊字符或权限不足。检查路径中是否有中文、空格或特殊符号尝试把仓库移到用户目录下如C:\Users\你的用户名\Documents\MyVault。问题三界面语言切换后部分菜单仍是英文。这是因为部分插件没有中文翻译。核心界面切换后插件的中文支持取决于插件作者是否提供了翻译文件。可以在插件设置中查看是否有语言选项。5.2 插件冲突与性能优化插件装多了之后Obsidian 启动变慢、编辑卡顿是常见现象。我的排查思路是先禁用所有第三方插件然后逐个启用观察是哪个插件导致的问题。常见的问题插件包括某些实时预览增强插件、大型 Dataview 查询、以及未优化的图表插件。性能优化方面有几个设置可以调整。在“关于”页面关闭“自动更新插件”改为手动更新避免后台下载拖慢速度。在“编辑器”设置中关闭“拼写检查”这个功能对中文用户意义不大。如果仓库笔记数量超过五千篇建议关闭“关系图谱”的实时渲染改为手动刷新。另外obsidian 的markdown格式块可以折叠么这个问题经常有人问。答案是肯定的Obsidian 原生支持标题折叠和列表折叠。在编辑器中把光标放在标题行左侧会出现一个折叠箭头点击即可折叠该标题下的所有内容。列表折叠需要开启“编辑器”设置中的“折叠缩进”选项。5.3 与 Zotero 联动及学术工作流对于学术研究者zotero和obsidian联动是一个高频需求。Zotero 是文献管理工具Obsidian 是笔记工具两者结合可以打造完整的学术工作流。实现方式是通过 Zotero 的 Better BibTeX 插件导出文献库为.bib文件然后在 Obsidian 中安装 Citations 插件配置.bib文件路径。这样在笔记中输入[citationKey]就能插入文献引用点击引用可以跳转到 Zotero 中的对应条目。更进一步的联动是通过 Zotero Integration 插件它可以把 Zotero 中的文献笔记包括注释和高亮直接导入 Obsidian并按照模板生成格式化的笔记。配置时需要安装 Zotero 的 Better Notes 插件并在 Obsidian 中设置导入模板。这个流程稍微复杂但一旦配置好文献阅读和笔记整理的效率会大幅提升。5.4 常见问题速查表问题现象可能原因解决方法下载速度慢服务器在海外换时段下载或使用镜像粘贴图片路径混乱附件路径未设置设置固定附件文件夹同步产生冲突文件多设备同时编辑开启 Git 自动拉取避免同时编辑插件安装失败网络问题或版本不兼容检查网络更新 Obsidian 版本中文搜索不准确分词问题安装中文搜索增强插件启动速度慢插件过多或仓库过大精简插件关闭实时预览链接失效文件移动或重命名开启自动更新内部链接移动端同步慢仓库文件过多使用 Git 稀疏检出或排除大文件6. 从入门到进阶的成长路径建议6.1 第一个月的使用节奏刚入坑 Obsidian 的前两周我建议你只做三件事写日记、建链接、用模板。不要急着装插件不要急着建复杂的目录结构更不要花大量时间研究主题美化。先把写笔记的习惯建立起来让 Obsidian 成为你每天都会打开的工具。具体来说每天用日记功能记录当天的工作和生活遇到值得深入的话题就用[[ ]]创建新笔记。每周花半小时整理一次 Inbox把有价值的笔记移到对应目录给孤立的笔记建立链接。一个月后你的仓库里应该会有三十篇左右的日记和十几篇主题笔记这时候再开始探索插件和高级功能。6.2 进阶方向与扩展玩法当你熟悉了基础操作后可以尝试以下几个进阶方向。第一是 Dataview 查询用代码块自动生成笔记列表比如“列出所有未完成的待办事项”或“显示本周创建的所有笔记”。第二是 Templater 脚本用 JavaScript 编写动态模板比如自动获取当前日期、自动生成文件标题、自动插入天气信息。第三是 CSS 片段通过自定义 CSS 调整界面细节比如修改标签颜色、调整表格样式、隐藏滚动条。codex如何读取obsidian这个问题涉及到 AI 工具与笔记库的集成。目前有一些社区插件可以实现类似功能原理是通过 API 读取仓库中的 Markdown 文件然后交给 AI 模型处理。如果你对这个方向感兴趣可以搜索“Obsidian AI 插件”了解最新进展。不过要注意这类插件通常需要配置 API 密钥使用成本需要自己评估。6.3 长期维护的心得体会用了两年 Obsidian我最大的体会是系统是长出来的不是设计出来的。一开始不要追求完美的分类和模板让笔记自然积累等痛点出现时再针对性解决。比如你觉得找笔记困难了就引入 MOC觉得图片乱了就整理附件文件夹觉得需要版本回溯了就配置 Git。另一个心得是定期回顾比勤奋记录更重要。我每周日晚上会花二十分钟浏览本周的日记和新建笔记把值得保留的内容整理到永久笔记中把临时的待办清理掉。这个习惯让我的仓库始终保持在一个可控的规模不会变成只进不出的“信息垃圾场”。最后分享一个我踩过的坑不要同时折腾多个笔记软件。我曾经在 Obsidian、Logseq、思源笔记之间反复横跳结果每个都只用了皮毛笔记也散落在各处。选定一个工具后至少深度使用半年把它的核心功能吃透再考虑是否需要迁移。工具是为人服务的不要让选择工具本身成为负担。