Gitee+PicGo 搭建 Markdown 笔记图床指南
介绍如何使用 Gitee、PicGo 和 Node.js 搭建图床,解决 Markdown 笔记中图片本地路径失效的问题。内容涵盖环境安装、仓库创建、Token 获取、插件配置及 Obsidian 集成,帮助实现图片自动上传至云端,确保跨设备访问稳定。

介绍如何使用 Gitee、PicGo 和 Node.js 搭建图床,解决 Markdown 笔记中图片本地路径失效的问题。内容涵盖环境安装、仓库创建、Token 获取、插件配置及 Obsidian 集成,帮助实现图片自动上传至云端,确保跨设备访问稳定。

你是否遇到过这样的场景:
本地 Markdown 笔记的'图片依赖本地路径',是困扰无数创作者的痛点。而解决这个问题的核心,就是搭建一个'图床'——把图片托管到云端,让链接永远有效。
本文将带你用'Gitee(国内免费仓库)+ PicGo(自动上传工具)+ Node.js(运行环境)'搭建图床,不仅解决'图片失效',还能实现:
从工具原理解析到 Step by Step 实操(包括环境搭建、插件配置、异常排查),甚至帮你避过 90% 的踩坑点。无论你是笔记爱好者,还是专业创作者,都能通过这篇文章彻底解决'图片链接失效'的心病。
在开始操作前,先搞懂四个核心概念,避免'盲目操作':
https://gitee.com/xxx.png)。,换电脑、分享给别人时,链接必然失效;https://gitee.com/用户名/仓库名/raw/分支/图片路径.png 直接访问(类似 GitHub 的 RAW 链接,但速度更快)。Ctrl+Alt+U)。gitee-uploader 插件(用 Node.js 开发),让 PicGo 能对接 Gitee。gitee-uploader)是用 Node.js 开发的,必须安装 Node.js 才能运行这些插件。简单说:Node.js 是'插件的发动机',没有它,PicGo 无法加载 Gitee 插件。访问 Node.js 官网,选择 LTS 长期支持版(如 18.18.0 LTS):
x64 Installer(64 位系统通用);.pkg 安装包;sudo apt install nodejs)。打开命令提示符(CMD),输入以下命令验证:
node -v
# 输出 Node 版本(如 v18.18.0)
npm -v
# 输出 npm 版本(如 9.8.1)
✅ 若正常输出版本,说明安装成功。
访问 PicGo 官网 或国内镜像,根据系统选择:
PicGo-Setup-xxx-x64.exe(64 位系统专属,性能更优);PicGo-xxx.dmg;PicGo-xxx.AppImage。Windows 一般建议选 2.4 的版本都是可以的,不要选 2.3 之前的老版本就行,因为老版本还不支持 gitee 插件。
注意这里可能会有一个小插曲——程序被报错不安全,这里直接选保留就行了。
启动 PicGo 后,右下角托盘会出现图标,右键→'打开主界面'即可操作。
img 或者 picture;初始化仓库:勾选(自动生成 README,便于管理);
登录 Gitee 官网,点击右上角'+'→新建仓库;
点击 Gitee 头像→'设置'→'私人令牌'→'生成新令牌';
PicGo 图床(方便记忆);提交后,复制生成的 Token(仅显示一次,务必保存到记事本!)。
命令行手动安装:
npm install picgo-plugin-gitee-uploader -g
先换国内 npm 源(加速下载):
npm config set registry https://registry.npmmirror.com
搜索框输入 gitee,找到 gitee-uploader 1.1.2 插件,点击'安装'。
⚠️ 若安装失败:请检查 Node.js 环境及网络。
点击'设为默认图床'→'确定',完成配置。
填写关键参数(参考示例):
| 参数 | 填写规则 | 示例 |
|---|---|---|
| repo | 用户名/仓库名(从 Gitee 仓库 URL 提取) | your_gitee_name/note-img-bed |
| branch | 仓库分支(可不写,默认 main 或 master) | master |
| token | 刚才复制的 Gitee Token | xxxxxxxxxxxxx |
| path | 图片存储路径(与仓库 img 文件夹一致) | img/ |
| customPath | 按日期分类(可选,如${year}/${month}/${day}) | 2025/09/16(自动生成) |
回到 PicGo 主界面→'图床设置'→选择'Gitee';
搜索 Image Auto Upload,点击'安装'→'启用'。
打开 Obsidian→'设置'→'社区插件'→'浏览';
端口:默认 36677, 上传接口默认为 http://127.0.0.1:36677/upload
若被占用,可在 PicGo→'设置'→'设置 Server'中修改。
![[pic.png]] 语法);https://gitee.com/xxx/xxx.png);验证:复制链接到浏览器,若能正常显示图片,则配置成功。
node -v 验证,若未安装则回到步骤二。repo 是否为 用户名/仓库名,path 是否与仓库 img 文件夹一致;projects 权限;path 和仓库实际文件夹是否一致(如 img/ 是否存在)。36678),并同步更新 Obsidian 插件配置。通过 Gitee(存储)+ PicGo(上传)+ Node.js(环境)的组合,我们实现了:
附录:工具速链

微信公众号「极客日志」,在微信中扫描左侧二维码关注。展示文案:极客日志 zeeklog
查找任何按下的键的javascript键代码、代码、位置和修饰符。 在线工具,Keycode 信息在线工具,online
JavaScript 字符串转义/反转义;Java 风格 \uXXXX(Native2Ascii)编码与解码。 在线工具,Escape 与 Native 编解码在线工具,online
使用 Prettier 在浏览器内格式化 JavaScript 或 HTML 片段。 在线工具,JavaScript / HTML 格式化在线工具,online
Terser 压缩、变量名混淆,或 javascript-obfuscator 高强度混淆(体积会增大)。 在线工具,JavaScript 压缩与混淆在线工具,online
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online