Obsidian 零基础完整教程一、概述1. 简介A. 是什么Obsidian 是一款基于本地 Markdown 文件的双向链接笔记工具，将知识管理与文本编辑完美结合。所有笔记以纯文本格式存储，用户拥有完全的数据控制权。B. 为什么选择 Obsidian在尝试过众多笔记工具后，选择 Obsidian 基于以下核心优势：数据完全自主可控，无厂商锁定风险界面流畅无卡顿，支持完全离线使用丰富的插件生态，可自由定制功能完美支持 AI 工具集成，提升知识管理效率C. 学完能做什么使用 Markdown 语法编写结构化笔记通过双向链接构建个人知识图谱集成 AI 工具实现自动化笔记管理利用插件扩展打造个性化知识系统2. 前置知识A. 必备技能基本电脑操作能力文件管理基础知识B. 推荐知识Markdown 基础语法（教程中会详细讲解）Git 基本操作（用于云端同步）二、环境准备1. 系统要求Obsidian 支持以下平台：Windows 10/11macOS 10.15+Linux（主流发行版）iOS 和 Android（移动端）2. 下载安装A. 访问官网打开 https://obsidian.md/，根据系统下载对应版本。B. 安装步骤下载安装包运行安装程序完成安装并启动 Obsidian3. 验证安装启动 Obsidian 后，会提示创建或打开笔记仓库。三、核心概念1. 基本术语仓库（Vault）：存储所有笔记的文件夹Markdown：轻量级标记语言，用于格式化文本双向链接：笔记间的智能引用机制插件：扩展 Obsidian 功能的组件知识图谱：可视化展示笔记关系的网络图2. 工作原理graph LR A[Markdown 文件] --> B[Obsidian 核心] B --> C[双向链接] B --> D[插件系统] B --> E[知识图谱] C --> E D --> E F[AI 工具] --> B3. 架构图Obsidian 采用本地优先架构，数据存储在本地文件系统中，插件系统提供扩展能力，双向链接机制构建知识网络。四、快速上手1. 创建笔记仓库A. 准备 GitHub 仓库注册 GitHub 账号（如没有）创建新仓库：点击 New Repository在本地找个文件夹，执行以下命令克隆仓库：git clone 仓库链接B. 配置 .gitignore在仓库根目录创建 .gitignore 文件，防止上传不必要的配置文件：.obsidian/workspace.json .obsidian/workspace-mobile.jsonC. 在 Obsidian 中打开仓库启动 Obsidian打开刚刚克隆下来的文件夹创建第一篇笔记2. 配置 Git 同步A. 安装 Git 插件点击第三方插件关闭安全模式点击浏览，搜索 git下载并安装第一个插件B. 配置自动同步在插件选项中配置更新时间打开自动同步按钮修改后右侧会显示 pull 提示3. 配置图片管理A. 安装 Custom attachment 插件在插件市场搜索 Custom attachment 并安装启用。B. 配置图片路径点击选项进行配置设置 Markdown URL 格式为：assets/${noteFileName}/${generatedAttachmentFileName}在文件与链接中配置相关选项C. 使用图片将图片复制到笔记中，路径会自动生成。可通过修改 [] 内的数字调整图片尺寸。五、Markdown 语法基础Markdown 是一种轻量级标记语言，在 Obsidian 中用于排版笔记内容。1. 标题分级使用 # 符号创建不同级别的标题，# 的数量决定标题级别：# 一级标题 ## 二级标题 ### 三级标题 #### 四级标题2. 文本格式化A. 加粗文本使用两个星号包裹文字：**这是加粗文字**B. 斜体文本使用一个星号包裹文字：*这是斜体文字*C. 高亮文本使用两个等号包裹文字：==这是高亮文字==D. 删除线使用两个波浪号包裹文字：~~这是删除线文字~~3. 列表与任务管理A. 无序列表使用 - 或 * 开头：- 列表项1 - 列表项2 - 子列表项B. 有序列表使用数字加点号开头：1. 第一项 2. 第二项 3. 第三项C. 任务列表使用 - [ ] 创建待办事项：- [x] 已完成的任务 - [ ] 未完成的任务 - [ ] 待处理的任务4. 代码块A. 行内代码使用反引号包裹：这是 `代码示例` 的效果B. 代码块使用三个反引号包裹，可指定语言实现语法高亮：```python def hello_world(): print("Hello, World!") ```5. 表格使用竖线和横线创建表格：| 列标题1 | 列标题2 | 列标题3 | |---------|---------|---------| | 内容1 | 内容2 | 内容3 | | 内容4 | 内容5 | 内容6 |6. 链接与图片A. 链接[显示文字](https://example.com)B. 图片![图片描述](图片链接)六、双向链接与知识图谱双向链接是 Obsidian 最核心的特性之一，它让笔记之间建立起有机的联系，构建个人知识网络。1. 什么是双向链接双向链接是一种高级的引用方式：当你在笔记 A 中引用笔记 B 时笔记 B 会自动显示被笔记 A 引用形成双向的关联关系这种机制让知识点自然串联，而不是孤立存在。2. 如何使用双向链接A. 基本语法使用双中括号 [[]] 创建链接：[[笔记名称]]B. 引用文件示例我本月写了一个教程 [[Obsidian零基础教程]]C. 链接到标题[[笔记名称#标题名称]] 例如：[[Obsidian教程#安装步骤]]D. 自定义显示文字[[实际笔记名称|显示的文字]] 例如：[[Markdown语法|MD语法]]E. 嵌入笔记内容使用 ![[]] 在当前笔记中显示被引用笔记的内容：![[笔记名称]]3. 创建双向链接的方法A. 方法1：拖拽创建在编辑模式下，直接从左侧文件列表拖拽笔记到编辑区自动生成双向链接语法B. 方法2：输入创建输入 [[ 后，Obsidian 会自动提示现有笔记选择或继续输入笔记名称如果笔记不存在，点击链接会自动创建C. 方法3：反向链接面板每篇笔记右侧会显示反向链接面板列出所有引用当前笔记的其他笔记点击可快速跳转4. 标签系统A. 创建标签#标签名称 #技术/编程/PythonB. 标签的作用快速分类和检索笔记在图谱中以不同颜色显示支持嵌套标签（用 / 分隔）5. 知识图谱A. 打开图谱点击左侧边栏的关系图谱图标或使用快捷键 Ctrl/Cmd + GB. 图谱功能节点：每个节点代表一篇笔记连线：连线表示笔记之间的链接关系颜色：可根据标签或文件夹设置不同颜色筛选：可以筛选特定标签或文件夹的笔记C. 图谱操作拖拽节点调整布局点击节点打开对应笔记放大缩小查看整体结构使用筛选器关注特定主题D. 实用技巧在笔记中建立知识网络：[[核心概念]] → [[具体应用]] → [[实践案例]]使用标签分类：#项目管理 #个人成长 #技术学习七、AI 结合 Obsidian 使用方式Obsidian 的纯文本架构天然适配 AI 工具，可以极大提升笔记管理效率。1. AI 自动化笔记管理通过 AI 工具（如 Gemini CLI）可以实现：A. 自动创建笔记AI 根据指令自动生成笔记文件和文件夹结构。B. 生成内容大纲输入主题，AI 自动生成详细的文章大纲和框架。C. 批量整理笔记AI 可以批量处理零散内容，整理为结构化的笔记。D. 示例操作# 使用 claude code 生成笔记 claude "帮我基于晴天写一首诗放到随笔里面"AI 会自动创建文件，然后写入到随笔里。2. Markdown 文件批处理AI 可以执行以下批量操作：重命名笔记时自动更新所有附件路径将零散的字幕或 OCR 内容整理为连贯段落自动添加 YAML 元数据（标题、日期、标签等）批量格式化代码块和表格3. 智能内容生成A. 内容摘要AI 指令：总结这篇文章的核心要点，用列表形式呈现输出：自动生成带复选框的 Markdown 段落B. 智能关联AI 通过分析笔记内容，自动建立双向链接在关系图谱中智能标注相关主题推荐相关笔记和参考资料4. 常用 AI 工具集成A. Gemini CLI执行自然语言指令处理笔记支持批量操作和自动化脚本输出标准 Markdown 格式B. Claude Code分析代码片段并插入注释通过代码块与 AI 交互生成技术文档和 API 说明C. 集成方式安装对应的 AI 工具 CLI 版本在 Obsidian 中通过命令行或插件调用设置自动化工作流，如每日自动总结笔记八、插件推荐Obsidian 的强大之处在于其丰富的插件生态。插件分为核心插件（官方自带）和社区插件（第三方开发）。1. 必备核心插件A. 大纲（Outline）实时显示当前笔记的标题结构点击标题快速跳转到对应位置便于查看和管理长文档结构B. 工作台（Workspaces）保存不同的工作布局一键切换学习、写作、项目管理等场景每个工作台可包含不同的笔记和面板组合C. 录音机（Audio Recorder）在笔记中直接录音录音文件自动保存在库文件中适合记录会议、讲座等场景D. 模板（Templates）创建笔记模板，避免重复输入支持日期、时间等动态变量适合日记、会议记录等固定格式笔记E. 设置方法1. 创建模板文件夹（如 Templates） 2. 在设置中指定模板文件夹位置 3. 创建模板文件，使用 {{date}} 等变量 4. 使用时点击插入模板2. 热门社区插件A. Calendar在侧边栏显示日历视图点击日期创建或打开日记笔记可视化查看笔记创建时间B. Advanced Tables快速创建和编辑 Markdown 表格自动对齐表格列支持表格排序和公式计算C. Templater比核心模板插件更强大支持 JavaScript 脚本可创建动态模板和自动化工作流示例模板--- title: <% tp.file.title %> date: <% tp.file.creation_date("YYYY-MM-DD HH:mm:ss") %> tags: ---D. Dataview将笔记当作数据库查询生成动态内容列表适合任务管理、项目追踪示例查询# 查询所有未完成任务 TASK WHERE !completedE. Excalidraw在 Obsidian 中绘制手绘风格图表支持流程图、思维导图可嵌入到笔记中F. Auto Link Title粘贴 URL 时自动获取网页标题生成格式化的 Markdown 链接节省手动输入标题的时间3. 插件使用建议A. 循序渐进不要一次性安装太多插件，先熟悉基本功能。B. 按需安装根据实际使用场景选择插件。C. 定期清理卸载不常用的插件，保持系统流畅。D. 查看文档每个插件都有说明文档，遇到问题先查阅文档。E. 社区交流加入 Obsidian 中文社区，获取插件推荐和使用技巧。4. 插件配置技巧A. 设置快捷键打开设置 → 快捷键搜索插件命令设置自定义快捷键九、进阶技巧1. 工作流优化建立每日笔记习惯使用模板加速创作定期整理和归档2. 知识管理原则以自己的话语记录建立知识间的连接持续迭代和更新3. 备份与同步使用 Git 进行版本控制定期备份到云端多设备同步配置十、常见问题1. 安装问题下载失败：检查网络连接，尝试使用镜像源无法启动：检查系统兼容性2. 配置问题插件无法安装：检查是否关闭了安全模式同步失败：检查 Git 配置和网络连接3. 使用问题图片无法显示：检查图片路径配置链接失效：检查笔记名称是否正确参考资料Obsidian 零基础教程 - 泊舟Obsidian 官方网站