p { font-size: 16px; line-height: 1.6; margin-bottom: 12px; }
h2 { font-size: 22px; margin-top: 24px; margin-bottom: 12px; color: #333; }
h3 { font-size: 18px; margin-top: 20px; margin-bottom: 10px; color: #555; }
code { background: #f5f5f5; padding: 2px 6px; border-radius: 3px; }
pre { background: #f5f5f5; padding: 16px; border-radius: 6px; overflow-x: auto; }
ul, ol { margin-left: 20px; }
li { margin-bottom: 8px; }
strong { color: #333; }
Obsidian 邪修用法笔记：免费云同步、AI、手机端与进阶技巧
目录
选择 Obsidian 的理由
视频作者最终选择 Obsidian 作为主力笔记工具，主要基于以下三个核心理由：
1. 数据安全：所有笔记本质上是本地独立的 Markdown 文件，即使软件开发者停止维护，数据也不会丢失，可以换用其他编辑器继续使用。
2. 界面丝滑流畅：UI 响应速度快，切换笔记、打开新窗口等操作无卡顿，有助于维持工作心流。
3. 与 AI 工具是绝配：天生适合与擅长处理本地文件的 AI 工具（如 Cursor、Gemini Code）搭配使用，能衍生出多种高效用法。
核心优势：数据安全与本地化
- Obsidian 的所有笔记都是存储在本地电脑上的独立 Markdown 文件。
- 这种本地化存储提供了极高的安全感，不依赖于任何云端服务。
- 作者建议可以组合多种备份策略（如 GitHub 同步、网盘备份、硬盘冷备份）来确保笔记永不丢失。
免费云同步方案：GitHub
作者推荐使用 GitHub 作为 Obsidian 笔记的免费云同步和备份方案。理由：GitHub 作为全球最大的源代码托管平台，是计算机科学的基础设施之一，其稳定性和安全性高于普通云笔记或网盘。
详细设置教程
- 创建 GitHub 仓库 (Repository)：
- 登录 GitHub，点击 “New” 创建一个新仓库。
- 为仓库命名（例如：
my-obsidian-vault）。
- 关键步骤：如果不想公开笔记，务必在 “Visibility” 处选择 Private（私有仓库）。
- 点击创建。
- 克隆仓库到本地：
- 下载并安装 GitHub Desktop 客户端（对新手友好，也可使用命令行）。
- 在 GitHub Desktop 中，点击 File -> Clone repository，登录账号后选择刚创建的仓库，并指定一个本地存放路径。
- 在 Obsidian 中打开仓库：
- 打开 Obsidian，选择 “Open folder as vault”，打开刚才克隆到本地的文件夹。
- 此后在此仓库文件夹内创建的所有 Markdown 文件（笔记）都会被 Git 管理。
- 排除不必要的配置文件：
- 为了避免同步冲突，需要将 Obsidian 的工作区状态文件排除在 Git 管理之外。
- 在仓库根目录新建一个名为
.gitignore 的文件。
- 在文件中添加以下两行内容：
.obsidian/workspace.json
.trash/
- 这样，
workspace.json（记录打开的笔记和布局）和回收站文件就不会被上传到 GitHub。
- 首次提交与同步：
- 在 GitHub Desktop 中，勾选需要提交的文件（通常是所有新增的笔记和
.gitignore 文件）。
- 在下方填写提交描述（例如：”Initial commit”），点击 “Commit to main”。
- 然后点击 “Push origin” 按钮，将本地提交推送到 GitHub 远程仓库。
- 完成后，可在 GitHub 网页端查看已同步的笔记文件。
自动化同步：Git 插件
为了省去每次修改后手动提交的麻烦，可以安装 Obsidian 社区插件实现自动化。
插件安装与配置教程
- 安装插件：
- 在 Obsidian 中，进入
设置 -> 第三方插件，关闭”安全模式”。
- 点击”浏览社区插件”，搜索并安装
Obsidian Git 插件。
- 安装后启用插件，并点击其”选项”进行配置。
- 关键配置选项：
Auto commit and sync after stopping file edits：勾选此项。当停止编辑文件一段时间后，自动尝试提交并同步到 GitHub。Vault backup interval (minutes)：修改自动备份间隔时间，作者设置为 1 分钟。即停止编辑1分钟后自动同步。Pull updates on startup：建议开启。每次启动 Obsidian 时，自动从 GitHub 拉取（Pull）最新改动，保持本地与远程同步。
- 测试：修改笔记后等待一分钟，Obsidian 右上角会出现提示，表示自动同步完成。也可以在 GitHub 网页端直接修改或创建文件，Obsidian 会在下次同步或启动时自动拉取到本地。
与 AI 工具集成
作者不推荐使用社区开发的 AI 插件，而是推荐使用专业的 AI 编程工具（如 Cursor、Gemini Code），因为它们由一线大厂出品，文件系统交互能力强，处理 Markdown 笔记更得心应手。视频以完全免费的 Gemini Code 为例进行演示。
环境准备与基础配置
- 安装 Node.js：前往 Node.js 官网下载并安装对应操作系统的版本。
- 安装 Gemini Code：
- 在 Obsidian 笔记仓库的根目录，右键选择”在终端中打开”。
- 复制 Gemini Code 官网提供的安装命令（如
npm install -g @google/gemini-code）并执行。
- 安装完成后，输入启动命令（如
gemini-code）启动工具，并按提示完成授权登录。
AI 应用案例演示
- 生成选题：
- 指令示例：”请根据我过往的脚本（存储在’自媒体’文件夹），结合网络搜索热点，帮我生成十个新的视频选题，并输出为一个
选题.md 文件。”
- 结果：AI 成功生成了如”本地运行大模型”、”自建密码管理器”等具有启发性的选题文件。
- 批量处理文件：
- 指令示例：”为这十个选题分别创建子文件夹（放在’未来选题’文件夹下），每个子文件夹内放入对应选题的大纲文件，然后删除根目录的
选题.md。”
- 结果：AI 准确创建了文件夹结构并移动/生成了对应文件，展示了其批量文件操作能力。
- 模仿文风写作：
- 指令示例：”搜索文章《忘了N8N吧，我用国产模型跑通了 ClaudeSkill》的内容，并参考我2024-2025年的笔记文风，撰写一个详细的视频脚本。”
- 结果：AI 能搜索到相关文章，并模仿作者风格生成包含开场、章节、实战步骤的脚本框架（但用词可能需人工调整）。
- 安全网：Git 版本控制：
- 无需担心 AI 误操作破坏或丢失文件，因为每一步修改都被 Git 记录。
- 如果对 AI 的修改不满意，可以在 GitHub Desktop 中右键文件，选择
Discard Changes，即可将文件状态回滚到修改前。
- 结论：Git 提供了完美的”撤销”安全网，可以放心让 AI 进行各种文件操作实验。
补充：本地 AI 知识库工具
- 如果经常需要 AI 搜索笔记内容，可以搭配 Hyperlink 这类本地运行离线 AI 模型的工具，将笔记库构建成本地 AI 知识库，保护隐私。
Markdown 语法快速复习
掌握基础语法即可使用 Obsidian 80% 的功能：
– 标题：# 一级标题， ## 二级标题，以此类推。
– 强调：
– 加粗：**文本** 或 __文本__
– 删除线：~~文本~~
– 高亮：==文本==（需插件支持）
– 代码：
– 行内代码：`代码`
– 代码块：```语言名称 ...代码... ```
– 列表：
– 无序列表：- 项目 或 * 项目
– 有序列表：1. 项目
– 引用：> 引用内容
– 链接与图片：
– 链接：[链接文本](URL)
– 图片：
– 其他：表格、分割线、数学公式块等可通过编辑器右键菜单快速插入。
进阶技巧：图片存储与管理
Obsidian 自带的图片粘贴功能会生成非标准 Markdown 链接，且文件管理混乱。通过插件可实现标准化、整洁化的管理。
插件配置教程
- 安装插件：在社区插件市场搜索并安装
Custom Attachment Location 插件。
- 插件设置：
- 在插件设置页面，找到
Markdown URL format 选项，填入：{{fileName}}/{{fileName}}。
Attachment path：选择存放附件的根目录（如 ./ 表示仓库根目录）。Attachment subpath：填入 assets/（或其他你喜欢的名称）。Rename attachment files：建议勾选，自动重命名附件文件。
- Obsidian 核心设置调整：
- 进入
设置 -> 文件与链接。
- 取消勾选
使用 Wiki 链接。
- 将
内部链接类型 设置为 基于当前笔记的相对路径。
- 效果：
- 粘贴图片时，Obsidian 会在
assets 文件夹下，创建一个与笔记同名的子文件夹，并将图片存入。
- 图片链接为标准 Markdown 格式：
。
- 重命名笔记时，对应的附件子文件夹也会同步重命名，链接自动更新。
- 此格式能被 VS Code、GitHub 网页端等任何标准 Markdown 渲染器正确显示图片。
- 调整图片大小：在图片 Markdown 语法末尾添加
|宽度，例如  可将图片宽度设为300像素。
优点：完全本地化，无需第三方图床，安全、隐私、免费、稳定，且文件结构清晰。
手机端使用与同步
可以在手机上使用 Obsidian 并保持与 GitHub 同步。
设置教程（以安卓为例）
- 传输笔记库到手机：
- 用数据线连接手机与电脑，选择”传输文件”模式。
- 在电脑上找到手机存储，建议将整个 Obsidian 笔记仓库文件夹复制到手机的
Documents 文件夹内。
- 在手机 Obsidian 中打开仓库：
- 在手机安装 Obsidian App。
- 打开 App，选择
Open folder as vault，找到并选择刚才复制进来的文件夹。
- 配置 Git 同步（关键）：
- 在手机 Obsidian 中，进入
设置 -> Git。
- 需要填写以下信息：
GitHub Username：你的 GitHub 用户名。GitHub Email：你的 GitHub 注册邮箱。GitHub Token：需要创建一个 Personal Access Token。
- 在电脑端登录 GitHub，进入
Settings -> Developer settings -> Personal access tokens -> Tokens (classic)。
- 点击
Generate new token (classic)。
- 为 Token 命名，选择过期时间（如永不过期），在权限（scopes）中勾选
repo（完全控制仓库）。
- 生成后，立即复制并妥善保存 Token 字符串（只显示一次）。
- 将 Token 粘贴到手机 Obsidian 的 Git 设置对应位置。
- 同步测试：在手机端创建或修改笔记，等待约1分钟（取决于自动同步间隔），即可在 GitHub 网页端和电脑端 Obsidian 看到更新。
注意事项：尽量避免手机和电脑同时编辑同一个文件，以防 Git 合并冲突。如果发生冲突，需要手动解决（网上有相关教程）。
笔记导出功能
使用插件可将 Obsidian 笔记导出为 Word、HTML、PDF 等格式。
插件安装与配置教程
- 安装插件：在社区插件市场搜索并安装
Enhanced Export 插件。
- 安装 Pandoc：该插件依赖 Pandoc 进行格式转换。
- 前往 Pandoc 的 GitHub Releases 页面，下载对应操作系统（如 Windows）的安装包（
.msi 或 .zip）。
- 如果下载的是压缩包，将其中的
pandoc.exe 解压到电脑的某个固定路径（如 C:\pandoc）。
- 配置插件：
- 在
Enhanced Export 插件的设置页面，找到 Pandoc Path 选项。
- 填入
pandoc.exe 的完整路径（例如：C:\pandoc\pandoc.exe）。
- 使用：在笔记上右键，选择
Enhanced Export，即可选择多种格式进行导出，导出的文档会包含正确显示的图片。
双向链接与知识图谱
这是 Obsidian 的核心特色功能，用于构建和可视化知识网络。
– 创建双向链接：在笔记中输入 [[，会弹出笔记搜索框，选择另一篇笔记即可创建链接。链接文本可以修改。
– 使用链接：按住 Ctrl (或 Cmd) 点击链接，会在新标签页打开被链接的笔记。
– 查看知识图谱：点击左侧边栏的”打开关系图谱”按钮，所有笔记会以节点形式显示，存在链接关系的笔记之间会用连线连接。
– 价值：有助于高效归纳整理知识，发现笔记间隐藏的关联，激发新的灵感和想法。
AI 总结
本视频系统介绍了一套高效、免费且注重数据安全的 Obsidian 使用方案。核心在于利用 GitHub 进行云同步与版本控制，确保了笔记的绝对安全和可追溯性。通过集成 Gemini Code 等 AI 编程工具，极大扩展了笔记的自动化处理能力，如生成内容、批量整理文件等，而 Git 则为此提供了安全的”实验沙盒”。此外，视频还详细讲解了通过插件优化图片管理、实现手机端同步、笔记导出以及利用双向链接构建知识网络等进阶技巧。这套”邪修”组合拳虽然略带极客色彩，但为解决笔记的云同步、AI 辅助、多端一致和数据安全等核心需求提供了强大、优雅且零成本的解决方案。
由小蓝整理发布
