引言:为什么要解决图片失效问题
你是否遇到过这样的场景:
- 用 Obsidian 写了半年的知识库,换电脑时发现所有图片都变成'破碎图标';
- 把 Markdown 笔记分享给同事,对方打开后图片全是本地路径,根本看不到内容;
- 尝试用云盘链接替代,却因为'防盗链'或'链接过期',图片还是无法正常显示……
本地 Markdown 笔记的图片依赖本地路径,是困扰无数创作者的痛点。而解决这个问题的核心,就是搭建一个'图床'——把图片托管到云端,让链接永远有效。
本文将带你用 Gitee(国内免费仓库)+ PicGo(自动上传工具)+ Node.js(运行环境)搭建图床,不仅解决'图片失效',还能实现国内访问快、完全免费、无缝对接 Obsidian。
一、概念扫盲:为什么需要这些工具?
在开始操作前,先搞懂四个核心概念,避免盲目操作。
1. 图床:图片的'云端仓库'
定义:专门用来存储图片的云端平台,核心是生成'永久可访问的图片 URL'。
类比:把图片当成'货物',图床就是'网络仓库',随时能通过链接提取货物。
解决的痛:本地笔记里的 ,换电脑、分享给别人时,链接必然失效;图床的链接是'云端地址',在哪台设备打开都能访问,彻底摆脱路径依赖。
2. Gitee:国内版'代码托管平台'
定义:类似 GitHub,但服务器在国内,是免费的代码/文件托管平台。
为什么选 Gitee 当图床?
- 访问快:国内节点,不用科学上网,图片加载秒开;
- 免费开源:创建'开源仓库'后,图片可被公开访问;
- 支持 RAW 链接:仓库里的图片能通过
https://gitee.com/用户名/仓库名/raw/分支/图片路径.png直接访问。
对比其他云盘,百度网盘的链接带防盗链,无法直接插入 Markdown;而 Gitee 的 RAW 链接是'纯静态文件地址',完美适配 Markdown 语法。
3. PicGo:图片上传'自动化神器'
定义:图片上传客户端,核心是'一键上传本地图片,自动生成网络链接'。
核心价值:把'登录 Gitee→找仓库→点击上传→复制链接'的繁琐步骤,压缩成'拖入图片→自动出链接'。
为什么需要插件? PicGo 默认支持 GitHub、七牛云等图床,但不直接支持 Gitee。这时需要安装 gitee-uploader 插件,让 PicGo 能对接 Gitee。
4. Node.js:插件的'动力引擎'
定义:让 JavaScript 代码能在电脑本地运行的运行时环境。
作用:PicGo 的插件是用 Node.js 开发的,必须安装 Node.js 才能运行这些插件。简单说:Node.js 是'插件的发动机',没有它,PicGo 无法加载 Gitee 插件。
二、环境搭建:Node.js 安装
1. 下载 Node.js
访问 Node.js 官网,选择 LTS 长期支持版(如 v18.18.0 LTS):
- Windows 用户选
x64 Installer(64 位系统通用); - macOS 选
.pkg安装包; - Linux 通过包管理器安装(如
sudo apt install nodejs)。
2. 安装与验证
以 Windows 为例,双击安装包,勾选'Add to PATH'(自动配置环境变量),一路点击'Next'即可。
打开命令提示符(CMD),输入以下命令验证:


