832 字
4 分钟
【教程】Obsidian+GitHub+PicList+OSS实现笔记同步

Obsidian+GitHub实现笔记同步#

Obsidian是什么?#

  • Obsidian 是一款基于 Markdown 文件的个人知识库与笔记管理工具,主要用于知识整理、笔记记录和构建个人知识体系。
  • Obsidian 采用本地文件存储方式,所有笔记都以普通 Markdown 文档形式保存,便于迁移、备份和长期管理。
  • Obsidian 和传统笔记软件最大的区别不是能记笔记,而是它把笔记变成一个可连接、可扩展、可计算的知识网络。。
  • 关于 Obsidian - Obsidian 中文帮助

使用Git管理笔记#

Git常用于代码仓库管理,类似的也可以用来管理笔记。

  • 在代码托管平台GitHub上创建个人笔记仓库并拉取到本地

  • 初始化.gitignore 排除.obsidian\workspace.json、.obsidian\workspace-mobile.json文件(用于记录工作区的布局和状态信息,例如面板位置、打开的文件等,这些文件在多端同步时可能会频繁变化,从而导致冲突问题,不用进行git管理)

  • 安装第三方插件-Git 为了更加方便的在obsidian中进行笔记的管理,需要安装Git插件:

  1. obsidian【设置】中关闭【安全模式】
  2. 【设置-第三方插件】中搜索Git插件并安装
  3. 插件常规设置: 开启未编辑文件时自动提交并同步到代码仓库(如1分钟未编辑同步一次) 自定义自动提交信息(提交信息文本描述) 开启推送&拉取前先同步一次远程笔记(避免冲突)

到这里就能实现在obsidian中通过git进行笔记的管理了,如下:

如何管理笔记图片?#

  • 还有个痛点问题:就是该如何管理obsidian中的图片? 如果还是使用git进行图片管理的话也不是不行,但是每次从网上或者截图软件中粘贴图片到obsidian中都是需要先【暂存】在本地然后再提交到git仓库,感觉很麻烦,有没有一种统一集中管理图片但不需要本地存储的方案呢?【有的兄弟有的,这样的方法有一个】那就是使用PicList + 对象存储实现图片云存储

  • 下载PicList PicList 是一个高效的云存储和图像托管管理工具,建立在 PicGo 的基础之上。它保留了 PicGo 的所有功能,同时增加了全面的云存储管理功能、各种实用功能以及全新的轻量级脚本系统。

无论你需要整理云文件、同步标记图片,还是轻松管理多个存储平台,PicList 都设计用漂亮的界面和强大的插件系统简化你的工作流程。

  • 安装Image auto upload插件 只有有PicList还不够,还需要搭配Obsidian中的插件才能实现粘贴图片调用PicList中的图像上传&删除接口:/upload、/delete

  • 配置PicList图床 可选的图床还是很多的,具体怎么配置参考官网教程-文件上传

最终obsidian中存储的只是图片的url,可在【PicList-相册】或obsidian中进行图片管理

  • 最终效果动图 /upload /delete:需要在PicList中开启删除云端这样就会删除存储在云端的图片

【教程】Obsidian+GitHub+PicList+OSS实现笔记同步
https://jzzt.cc.cd/posts/编码教程/教程-260528笔记同步/
作者
局子粥头
发布于
2026-05-28
许可协议
CC BY-NC-SA 4.0