Obsidian 配合 Github 与坚果云实现笔记同步方案

.obsidian/workspace.json
.obsidian/workspace-mobile.json
.obsidian/last-sync-state.json
.nutstore/

说明：

前两行排除 workspace.json 文件（含电脑端和手机端）。第三行排除缓存信息以保持仓库干净。最后一行忽略坚果云的冲突文件和配置。

使用 Git 插件自动上传文件

推荐使用 Obsidian 插件实现自动上传。

在插件市场搜索【git】，下载并启用。

参考以下设置（图中已标注说明）：

测试新建文件夹编写信息，观察是否自动同步。

提交成功但未获取 GitHub 权限。

申请 PAT

关键步骤，请参照图片操作。

右侧有创建 token 选项，点击。

最下方选择创建 token。

Token 仅出现一次，请妥善保存。

设置 PAT 权限

点击创建的 PAT，选择编辑。

访问选择所有仓库，添加两个权限：

• contents: read and write
• metadata: read-only

更新配置后，再次编辑笔记，GitHub 仓库应能同步且无错误提示。

如何使用坚果云配合 GitHub 实现两端同步

GitHub 基于本地文件夹同步，坚果云也同步本地文件。直接修改会产生冲突，建议采用以下方式。

让坚果云文件变成 Git 仓库

登录 GitHub，新建 Private 仓库。

用 GitHub Desktop 克隆该仓库。

选择克隆，记录路径 A。

步骤 1： 将路径 A 下的 .git 文件夹剪切到坚果云存放笔记的位置 B。

步骤 2： 剪切后 GitHub Desktop 会提示找不到库，需重新选择本地知识库位置为 B。

对比 GitHub 仓库效果，全选文件提交请求。

GitHub 仓库中已同步上来。

原理：

• 物理文件：只存在于本地坚果云同步的文件路径下。
• 坚果云：监测到文件变动，同步到云端。
• GitHub/Git 插件：监测到目录下的 .git 文件夹，根据配置 push 到 GitHub 云端。
• 结果：一份本地文件，两份云端备份，互不干扰。

小贴士：原 /Users/liuhuahui/Documents/GitHub/knowledge_value 文件夹若不再需要可删除，以后直接在坚果云路径下操作。

如何使用 Obsidian 来增效

图片存储功能

Obsidian 默认图片存储功能存在不足：

1. 图片自动存储在同级目录，文件多时混乱。
2. 链接非标准 Markdown 语法，GitHub 等环境无法显示。

推荐使用插件 Custom Attachment Location 标准化图片语法。

在第三方插件市场检索下载并启用。

修改三个设置：

Markdown URL 格式：assets/${noteFileName}/${generatedAttachmentFileName}

回到系统设置，选择文件与链接，修改两个设置：

配置完成，图片将存储在 assets 文件下的同名文件夹中。

Obsidian 手机端同步

将知识库文件复制到手机端，解压后打开。

打开手机端 Obsidian，选择 open folder as vault 打开解压后的文件。

设置 Git： 编辑 Authentication/commit author 栏信息：

• username: GitHub 用户名
• password: Token（见下文）
• author name: 用户名
• email: GitHub 注册邮箱

申请 Token 并填入密码栏：

点击生成 Token，复制保存（仅出现一次），粘贴至手机端 password 选项框。

手机端设置完成，尝试新建笔记验证同步。

注意事项：不建议电脑端和手机端同时编辑同一篇笔记，易导致同步问题。