你是不是也看过别人精心搭建的笔记库,瞬间被震撼到,心想:我也要整一个这样的!

于是你开始折腾,从备忘录换到 Notion,再从 Notion 换到语雀,最后发现 Obsidian 不仅支持本地存储,还能接入 AI 对话。你兴冲冲地下载下来,结果刚粘贴几张截图,就发现图片全堆在根目录,看着一团乱麻,体验极差。

别担心,今天这篇文章就是来解决这些问题的。跟着走完,你会拥有一个:能云同步、图片自动上传、还支持 AI 对话的本地知识库。

内容涵盖以下四个部分:

  1. 笔记仓库准备(Git + Gitee)
  2. 下载安装 Obsidian
  3. 自动上传,实现云同步
  4. 图片打包上传到图床
  5. 插件推荐

一、笔记仓库准备

在安装 Obsidian 之前,我们先把"家"建好——用 Git + Gitee 搭一个云端仓库,后续笔记的同步和备份都靠它。

需要准备的两个工具

  1. Git:版本管理工具,点进去下载后无脑安装即可,不需要任何额外配置。
  2. Gitee:国内版 GitHub,不需要科学上网,注册一个账号就好。

在 Gitee 上创建仓库

注册登录 Gitee 后,新建一个仓库,名字随意起,比如 my-obsidian-notes

image.png|697
image.png
image.png

把仓库克隆到本地

创建好仓库后,复制仓库的 clone 地址:

image.png

在你电脑上选一个文件夹(不要放在 C 盘),进入该文件夹,右键 → 在终端中打开

image.png

在终端里输入以下命令,把你刚复制的地址粘贴上去:

git clone 你复制的地址

image.png|697
image.png

执行完成后,你会看到文件夹里多了一个新目录,这就是你的本地仓库。

接下来还需要再执行几条初始化指令(按截图,一条一条粘贴回车):

image.png

粘贴后按回车,没有任何输出是正常的,不用担心。

✅ 阶段小结

能走到这一步,说明你已经完成了最难的准备工作,绝大多数人卡在这里就放弃了,你比他们强。

如果对 Git 和 Gitee 的配合还不太熟悉,可以看这个视频:Git 和 Gitee 的使用

视频太长也没关系,只需要掌握一件事:能把文件上传到仓库就够了,其他都不重要。

遇到问题的话,直接把问题甩给 AI(豆包、ChatGPT 都行),问一句:

怎么用最简单的方法使用 git 将文件上传到 gitee?

image.png


二、下载安装 Obsidian

下载 Obsidian

认准官网下载,不要随便从第三方渠道下载盗版:👉 obsidian.md

image.png

下载后直接安装,不需要登录账号,打开即用。

image.png

设置仓库

安装完成后,Obsidian 会让你选择一个"库"(Vault)。

还记得刚才克隆下来的 Gitee 仓库文件夹吗?直接选中它就好,不需要新建,把它作为你的笔记库打开即可。

选好之后,笔记界面就出来了!

image.png


三、☁️ 自动上传,实现云同步

仓库建好了,下一步让笔记能自动同步到云端,不用每次手动 push。

第一步:添加 .gitignore 文件

用 Obsidian 打开仓库后,回到你的本地仓库文件夹,你会发现里面多了一个 .obsidian 文件夹:

image.png

点进去,里面有四个文件:

image.png

退回到上一级目录,新建一个名为 .gitignore 的文件:

image.png

用记事本打开它,输入以下两行内容,然后保存

.obsidian/workspace.json
.obsidian/workspace-mobile.json

image.png

这一步是为了告诉 Git,这两个文件不需要同步,避免不同设备之间的配置冲突。

第二步:安装 Git 插件

回到 Obsidian,打开设置:

image.png

进入「第三方插件」,关闭安全模式:

在插件市场搜索 git,安装并启用:

image.png

第三步:配置插件

进入插件选项,按照我的配置截图设置即可:

image.png

往下拉,还有一处需要配置:

image.png

!⚠️ 如果你遇到了一些问题,可以在终端输入以下

git fetch --all --prune
git branch --unset-upstream
git push -u origin master

配置完成后,云同步就搞定了。效果是这样的:

  • 设备 A 编辑完笔记,停止操作 2 分钟后,笔记自动上传到 Gitee
  • 设备 B 打开 Obsidian,笔记自动同步到最新状态

⚠️ 前提:两台设备都需要安装相同的插件并完成配置。


四、🖼️ 图片自动上传图床

解决了同步问题,再来解决图片问题。

直接把截图粘进 Obsidian,图片会堆在本地文件夹里,换设备看就全是空白。解决方案:把图片自动上传到 Gitee 的"图床仓库",笔记里只存链接,任何设备都能正常显示。

第一步:在 Gitee 上创建图片仓库

和之前一样,在 Gitee 上新建一个仓库,专门用来存图片。这个仓库不需要克隆到本地,只需要在线创建就行。

建议起一个好认的名字,比如 my-obsidian-img

第二步:获取 Gitee 私人令牌

打开 Gitee 个人设置,找到「私人令牌」:

image.png
image.png

过期时间一定要选"永不过期",否则令牌失效后图片就全上传不了了:

image.png

生成后立刻复制保存,这个令牌只显示一次,可以先发给自己微信:

image.png

第三步:安装并配置 PicGo

PicGo 是一个图床工具,负责把图片自动上传到 Gitee。

安装完成后,因为我们用的是 Gitee,还需要额外安装一个插件。在 PicGo 插件市场搜索 gitee,安装 gitee 2.0.7

image.png

安装后进入插件配置界面:

image.png

按照以下说明填写:

  • owner:你的 Gitee 用户名(主页 @ 后面那串)
  • repo:图片仓库名称,务必填写准确
  • token:刚才保存的令牌
  • 其余项保持默认

image.png

第四步:安装 Obsidian 图片上传插件

回到 Obsidian,在插件市场搜索 Image auto upload,安装并启用:

image.png

配置和我保持一致即可:

image.png

完成!以后在 Obsidian 里粘贴截图,图片会自动上传到 Gitee 图床,笔记里保存的是图片链接,不占本地空间,换设备也能正常显示。

💡 Gitee 单仓库容量很大,真的用满了再新建一个仓库就好,很简单。


五、🧩 插件推荐

走到这里,基础已经全部搭好了。下面是几个能显著提升体验的插件,按需安装:

插件名 作用
Calendar 日历视图,可以快速跳转到某天的日记
Periodic Notes 配合 Calendar,自动创建日记/周记/月记
Manual Sorting 支持手动拖拽排序文件夹和笔记
Editing Toolbar 给编辑界面加一个工具栏,插入格式不用记快捷键

到这里,你的 Obsidian 已经完成了:✅ 本地存储 ✅ Gitee 云同步 ✅ 图片自动上传图床 ✅ 基础插件配置

一个真正好用的知识库,搭起来了。

Logo

有“AI”的1024 = 2048,欢迎大家加入2048 AI社区

更多推荐