Gitee+PicGo 图床搭建：专治 Markdown 笔记图片失效的完整方案

Gitee+PicGo 图床搭建：解决 Markdown 图片失效问题

在撰写 Markdown 文档时，图片链接失效或本地图片无法跨平台同步是常见问题。通过 Gitee 仓库结合 PicGo 工具搭建图床，可以实现图片的稳定存储与快速插入。

准备工作

确保已安装 Node.js 环境，并拥有 Gitee 账号。Gitee 作为国内代码托管平台，访问速度快，适合存储图片等静态资源。PicGo 是一个支持多图床管理的开源工具，支持 Windows、macOS 和 Linux 系统。

创建 Gitee 仓库

登录 Gitee 后新建一个公开仓库，用于存放图片文件。仓库名称建议简洁明了，例如 image-host。初始化仓库时勾选 README 文件，便于后续管理。进入仓库设置页面，生成一个私人令牌（Private Token），权限勾选 projects 和 user_info，保存生成的 Token 备用。

配置 PicGo

下载并安装 PicGo 客户端，打开主界面后进入图床设置。选择 Gitee 图床，填写以下信息：

• owner：Gitee 用户名
• repo：仓库名称
• token：之前保存的私人令牌
• path：图片存放路径，例如 img/
• customPath：选择 年/月/日 格式自动分类

保存配置后设为默认图床，点击 确定 完成设置。可通过拖拽图片到 PicGo 窗口测试上传功能，成功后会返回 Markdown 格式的图片链接。

优化使用体验

在 PicGo 设置中开启 时间戳重命名，避免图片名称冲突。启用 上传后自动复制链接，提升编辑效率。对于需要频繁插入图片的场景，可搭配 Typora 等编辑器，在偏好设置中配置 PicGo 路径，实现粘贴图片后自动上传至图床。

注意事项

Gitee 公开仓库的单文件大小限制为 50MB，适合个人博客或文档使用。如需更高容量或隐私保护，可考虑升级为付费仓库。定期检查仓库容量，避免因超额导致服务中断。通过此方案，Markdown 文档中的图片链接将永久有效，跨设备同步时无需担心图片丢失问题。