图床概述
约 1683 字大约 6 分钟
2026-06-10
图床用于在编辑器插入本地图片时,将图片上传到指定服务器或云端账户,并把返回的图片地址写入 Markdown。与只保存在本机的相对路径图片相比,图床链接更便于在不同设备、编辑器或发布平台之间共享文档。
奕澄Markdown目前提供两种图床类型:
| 类型 | 上传目标 | 适合场景 | 写入 Markdown 的地址 |
|---|---|---|---|
| 服务器地址 | 你配置的 HTTP 图片上传接口 | 已有 PicGo 风格接口、自建图片服务 | 接口返回的 http(s) 图片 URL |
| 云端地址 | 绑定的 WebDAV 或 S3 账户 | 希望将图片集中存放到自己的网盘或对象存储 | 根据云端直链域名、CDN 或公开端点生成的 URL |
具体配置请继续阅读:
当前 设置 > 图床设置 和 个性化设置 > 编辑器 > 编辑器应用图床 属于永久 Pro 功能入口。未开通时,应用会显示相应会员提示;具体权益以应用内页面为准。
图床不是本地图片插入模式
未使用图床时,图片会按照 个性化设置 > 图片 > 图片插入模式 保存到本地,并在 Markdown 中写入相对路径。当前可选:
- 复制到
./assets,默认方式。 - 复制到当前文件夹
./。 - 复制到
./assets/${filename},按当前 Markdown 文件名建立子目录。 - 自定义路径,支持
${filename}匹配当前 Markdown 文件名。
启用图床后,本地图片会优先按默认图床上传;上传失败时仍会保留本地图片,并回退为上述本地相对路径,不会因为上传失败而直接丢失插图。
启用图床的完整步骤
1. 新建图床
进入 设置 > 图床设置,点击右上角新建按钮,选择 新建图床。根据类型填写上传接口或绑定云端账户,然后保存。
2. 设置默认图床
在图床编辑页或图床列表中打开 是否启用。启用的图床就是当前默认图床。
- 可以同时保存多个图床配置,但默认图床只能有一个。
- 启用另一个图床时,应用会提示是否切换默认图床。
- 停用当前默认图床后,编辑器恢复为本地图片插入规则。
- 新建、编辑、删除或切换图床不会改写文档中已经插入的图片链接,只影响之后的上传操作。
3. 打开编辑器应用图床
进入 个性化设置 > 编辑器 > 编辑器应用图床,确认开关已打开。该开关默认开启,但只有同时存在可用的默认图床时,才会实际上传图床。
关闭此开关后,编辑器插入图片只保留本地,不再按默认图床上传。手动重传图床前,也需要重新打开该开关并确认默认图床可用。
4. 插入图片并检查结果
通过相册选择、底部工具栏、裁剪或手写插图、粘贴本地图片等方式插入图片。上传成功后,Markdown 中会出现图床返回的绝对 URL,例如:
建议第一次配置后,先在测试文档中插入一张图片,再确认:
- 图片是否出现在预期服务器或云端目录。
- Markdown 中是否为预期的
http(s)地址。 - 该地址在不登录账户的浏览器中是否能直接打开。
编辑器内的手动上传
对于已经以本地相对路径插入的图片,可以在编辑器中长按图片,或在电脑端右键图片,使用:
- 上传此图片到图床:只重传当前图片。
- 上传全部本地图片到图床:批量处理当前文档中的本地图片。
上传成功后,对应的本地引用会替换为图床 URL。单张失败不会影响其他图片;失败的图片仍保留本地引用,可在修复配置或网络后重试。
这些菜单处理的是本地图片。已经是 http(s) 地址的网络图片,不会因为设置了默认图床就自动转传;粘贴网络图片时,仍遵循 网络图片应用图片插入模式规则 等现有设置。
云端地址图床与云端资源上传的区别
“上传到图床”和“上传到云端”是两条不同通道,不要只看名称混淆:
| 对比项 | 云端地址图床 | 云端资源上传 |
|---|---|---|
| 主要目的 | 获得可公开加载的图片 URL | 让云端文档及其图片按相对路径一起流转 |
| 使用账户 | 图床中显式绑定的 WebDAV/S3 账户 | 当前云端文档同步账户 |
| 保存位置 | 云端账户根目录下的图床根目录,默认 YICHENG_IMAGEHOST | 当前 Markdown 对应的云端镜像位置,例如文档旁的 assets |
| 写入 Markdown | 公网 http(s) 绝对 URL | 本地/云端相对路径 |
| 是否要求公网直链 | 必须,否则其他环境无法直接加载图片 | 不要求,云端同步仍使用账户鉴权 |
当正在编辑云端镜像文档,且 云端资源上传为自动 时,插图会优先上传到云端镜像位置并插入相对路径,优先级高于默认图床。此时如果明确希望上传到图床,请使用图片菜单中的 上传此图片到图床 或 上传全部本地图片到图床;显式图床上传不会被云端自动上传接管。
失败回退与安全注意事项
- 上传超时、网络失败、服务器返回错误或响应格式不符合要求时,应用会提示并保留本地图片及相对路径。
- 图床上传不会删除或移动作为上传来源的本地图片,后续是否清理由你决定。
- 删除图床配置、删除 Markdown 或删除本地图片,不会自动删除已经上传到第三方的远程图片。
- 图床链接通常需要长期有效且免认证访问。不要把账户密码、Secret Key 或带长期有效凭证的 URL 写入公开文档。
- 用于私人图片时,请谨慎配置公开读、CDN 和分享权限;公网直链一旦传播,其他人可能直接访问对应图片。
