

> 关键词：StackEdit、Gitea、图床、OAuth2、Markdown  

十分钟配置，终身免折腾。  
---

## 1. 为什么要自己折腾
- 公有图床随时挂 / 防盗链  
- 完全免费
- Git 仓自带版本管理，图片也能回滚  
- 写完 Markdown `push` 即发布，一次配置，全平台通用  

---

## 2. 最终效果
在 StackEdit 里  
1. `Ctrl+V` 粘贴图片 → 自动上传到你的 Gitea 仓库  
2. 生成的 Markdown 链接永久可用，自带 CDN 加速（jsDelivr 可再套一层，本文不提）  

![image.png](https://developer.qcloudimg.com/http-save/yehe-11177336/2b392520814cc3ecdac6ca1847489f19.png)
---

## 3. 准备工作
1. 一个 **Gitea 账号**（示例用官方站 [https://gitea.com](https://gitea.com)，自建同理）  
2. 新建 **公开仓库** `img`（私有仓也能用，但公有仓方便直链）  
3.  StackEdit 中文版 → [https://stackedit.cn](https://stackedit.cn) 登录（GitHub / Gitee 一键登录即可）

![输入图片说明](https://developer.qcloudimg.com/http-save/yehe-11177336/6765105152f5ea12726b3dbc58aa39dd.png)

---

## 4. 步骤总览
| 阶段 | 目标 |
|----|----|
| ① | 在 Gitea 创建 OAuth2 应用，拿到 `Client ID / Secret` |
| ② | 把 ID 和 Secret 填回 StackEdit，完成授权 |
| ③ | 配置图床路径（按日期分文件夹） |
| ④ | 测试粘贴图片，验证成功 |

---

## 5. 详细操作

### 5.1 创建 OAuth2 应用
1. 登录 Gitea → 右上角头像 → **Settings** → **Applications** → **OAuth2 Applications** → **Create a new OAuth2 Application**  

![输入图片说明](https://developer.qcloudimg.com/http-save/yehe-11177336/1c75cf51003a46748c78ee0d873513f4.png)

2. 填写内容  
   - **Application Name（应用名称）**：`StackEditCN`（随意）  
   - **Redirect URI（重定向URI）**：必须填 `https://stackedit.cn/oauth2/callback`  

3. 点击 **Create** 之后会看到  
   - Client ID → 对应 StackEdit 的 **Application ID**  
   - Client Secret → 对应 **Application Secret**（只显示一次，先复制到记事本）

![输入图片说明](https://developer.qcloudimg.com/http-save/yehe-11177336/a9095a854060e3b0cbf78b0a629a1188.png)

---

### 5.2 在 StackEdit 里绑定 Gitea
1. 打开 StackEdit 图片设置

![输入图片说明](https://developer.qcloudimg.com/http-save/yehe-11177336/e940b3ac3307565544d8fa751de2a6ce.png)

2. 在弹出框里填写  
   - **Gitea URL**：`https://gitea.com`（注意：只填域名，别带仓库路径）  
   - **Application ID**：刚才的 **Client ID**  
   - **Application Secret**：刚才的 **Client Secret**  

![输入图片说明](https://developer.qcloudimg.com/http-save/yehe-11177336/3fa4ac263d21af06133f0f105429e27b.png)

3. 点击 **Confirm**，页面会跳到 Gitea 询问授权 → **Allow** → 自动回到 StackEdit，绑定完成！
4. 再次进入 **Gitea 设置**（同一窗口）：

| 字段 | 推荐值 | 说明 |
| --- | --- | --- |
| **Repository URL** | `https://gitea.com/<你的用户名>/img` | 不带 `.git` |
| **Folder Path** | `imgs/{YYYY}-{MM}-{DD}` | 自动按日期归档 |
| **Branch** | `master` 或 `main` | 看你仓库默认分支 |

点击 **Confirm** 保存。

![输入图片说明](https://developer.qcloudimg.com/http-save/yehe-11177336/e6214df5eaf79eb0da1de6f2b76b93d0.png)

---

### 5.3 上传测试
1. 新建或打开任意 Markdown  
2. 直接 `Ctrl+V` 粘贴一张截图  
3. 观察编辑器内链接变为 `https://gitea.com/xxx/raw/branch/...` → 成功！  
4. 回到仓库页面，能看到对应日期文件夹里多了一张图片

![输入图片说明](https://developer.qcloudimg.com/http-save/yehe-11177336/7f918a4e35918731c4dc3f6f6c0d4841.png)

---

## 6. 常见问题速查
| 现象 | 解决 |
| --- | --- |
| 授权后 404 | **Gitea URL** 填成了仓库地址，应只填域名 |
| 上传失败 403 | 仓库是私有的，把链接前面的 `raw` 换成 `media` 需带 token；或干脆用公开仓 |
| 想换路径 | 修改 **Folder Path** 即可，老图片不动，新图片走新目录 |




生成的 Markdown 链接永久可用，自带 CDN 加速（jsDelivr 可再套一层，本文不提）

用 Gitea 给 StackEdit 搭一个「图床」- 详细步骤截图

高级后端开发工程师

开发工具

后端

"十分钟配置Gitea+StackEdit图床，实现Markdown图片自动上传。通过OAuth2授权，粘贴图片即上传至Gitea仓库，支持版本管理和CDN加速。详细步骤包括创建OAuth2应用、绑定StackEdit、配置路径等，解决公有图床不稳定问题，一次配置全平台通用。"

GitHub

域名特惠新用户低至1元！


domain

CDN 境内流量包 1元起 ，更有新老同享套餐包0.09元/GB起，立即选购


文章

问答

视频

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

用 Gitea 给 StackEdit 搭一个「图床」- 详细步骤截图-腾讯云开发者社区-腾讯云

用 Gitea 给 StackEdit 搭一个「图床」- 详细步骤截图

用 Gitea 给 StackEdit 搭一个「图床」- 详细步骤截图

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐