Markdown 笔记图片自动上传方案：Gitee + PicGo 搭建指南
背景与痛点
本地 Markdown 笔记常面临一个棘手问题：图片依赖本地路径。换电脑时，所有图片变成'破碎图标'；分享给同事，对方看到的只是本地文件路径，无法显示内容。云盘链接又常因防盗链或过期失效。
解决的核心是搭建图床——将图片托管到云端，生成永久有效的 URL。本文将介绍使用 Gitee（国内免费仓库）、PicGo（自动上传工具）和 Node.js（运行环境）搭建图床的方案。这不仅能解决链接失效，还能实现国内访问快、完全免费、无缝对接 Obsidian 等效果。
一、核心概念解析
在操作前，先理解四个关键组件的作用，避免盲目配置。
1. 图床：图片的云端仓库
定义是专门存储图片的云端平台，核心在于生成'永久可访问的图片 URL'。
- 解决的问题：本地笔记中的相对路径（如
./images/pic.png）在跨设备或分享时会失效。图床提供的是云端地址，任何设备打开都能访问。
2. Gitee：代码托管平台
类似 GitHub，但服务器在国内，支持免费的代码/文件托管。
- 选择理由：国内节点访问速度快，无需特殊网络环境；创建开源仓库后，图片可被公开访问；支持 RAW 链接，完美适配 Markdown 语法。
3. PicGo：图片上传客户端
一款自动化图片上传工具，核心功能是'一键上传本地图片，自动生成网络链接'。
- 核心价值：将繁琐的登录、上传、复制链接步骤压缩为'拖入图片→自动出链接'，甚至支持快捷键操作。
4. Node.js：插件运行环境
让 JavaScript 代码能在本地运行的运行时环境。
- 作用：PicGo 的部分插件（如 Gitee 上传插件）基于 Node.js 开发，必须安装此环境才能加载并运行这些功能。
二、环境搭建：Node.js 安装
这是基础步骤，必须完成。
1. 下载 Node.js
访问 Node.js 官网，选择 LTS 长期支持版（如 v18.x）。
- Windows 用户选
x64 Installer。 - macOS 选
.pkg安装包。 - Linux 可通过包管理器安装（如
sudo apt install nodejs）。
2. 安装与验证
以 Windows 为例：
- 双击安装包，勾选 'Add to PATH'（自动配置环境变量）。
- 一路点击 'Next'，使用默认路径安装。
打开命令提示符（CMD），输入以下命令验证安装是否成功：
node -v
npm -v
若正常输出版本号（如 v18.18.0），说明环境就绪。
三、PicGo 安装与启动
1. 下载对应版本
访问 PicGo 官网，根据系统选择：
- Windows：优先选
PicGo-Setup-xxx-x64.exe。 - macOS：选
.dmg文件。 - Linux：选
.AppImage。 建议选用较新版本（如 2.4+），旧版本可能不支持部分插件。
