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