MarkText图床配置终极指南：彻底解决Markdown图片显示问题

2026年5月14日21:50:11

如果你用Markdown写博客或技术文档，一定遇到过这样的场景：本地写好的文章，图片显示一切正常，一旦发布到CSDN、博客园或自建博客上，图片全都变成了裂开的占位符。原因很简单——你的Markdown文档里引用的是本地路径，而互联网上的读者根本访问不到你电脑里的文件。这时候，图床就是你绕不开的解决方案。本文将手把手教你如何在MarkText中配置图床，实现图片自动上传。

一、为什么需要图床？

Markdown文档中的图片是以链接形式存在的，通常写作![alt](图片路径)。如果路径指向本地文件（如./images/photo.png），那么换一台设备或发布到网络上后，图片就会失效。图床的本质是一个可公开访问的图片存储服务，将图片上传到图床后，你会获得一个URL链接，在任何地方都能正常显示。

MarkText内置了图片上传功能，支持SM.MS图床和GitHub图床，还能通过PicGo-Core扩展支持更多图床类型（如七牛云、腾讯云COS、AWS S3等）。

二、方案一：MarkText + GitHub 图床（推荐新手）

这是配置最简单、成本最低的方案。GitHub提供免费的公共仓库，图片存储完全免费，没有流量限制。

步骤1：创建GitHub仓库

登录GitHub，新建一个公共仓库（如my-images），用于存放图片。仓库名可以任意取，建议勾选"Add a README file"初始化仓库。

步骤2：生成Personal Access Token

进入GitHub的 Settings → Developer settings → Personal access tokens → Tokens (classic)，点击"Generate new token"，勾选repo权限，生成后务必保存好这个Token（它只显示一次）。

步骤3：安装PicGo-Core

MarkText只能识别通过npm全局安装的PicGo-Core，不能使用PicGo桌面版。打开终端执行：

npm install picgo -g

安装完成后，用where picgo（Windows）或which picgo（macOS/Linux）验证是否安装成功。

步骤4：配置PicGo并设置GitHub为默认图床

在终端中依次执行：

picgo set uploader —— 选择github，按提示填入仓库名（格式：用户名/仓库名）、分支名（main）、Token和存储路径

picgo use uploader —— 选择github作为默认图床

步骤5：在MarkText中启用图床上传

打开MarkText → File → Preferences → Image，将图片上传方式设置为"Upload to cloud"。现在你在MarkText中粘贴图片时，编辑器会自动调用PicGo将图片上传到GitHub，并将本地路径替换为在线URL。

三、方案二：MarkText + 七牛云图床（推荐有域名的用户）

如果你有自己的域名，七牛云图床是更好的选择。上传速度更快，图片加载也更稳定，而且七牛云提供每月10GB的免费存储空间和CDN流量。

配置思路与GitHub方案类似，区别在于需要在PicGo中安装七牛云的S3插件（picgo add s3），然后配置七牛云提供的AccessKey、SecretKey、Bucket名称和访问域名。具体参数可以在七牛云控制台的"对象存储"中找到。

四、常见问题与解决

• 提示"picgo未安装"：确保是通过npm全局安装的picgo（而非桌面版），且Node.js版本在14以上。
• 上传后图片仍是虚线：虚线表示正在上传或上传失败。检查Token权限是否包含repo，仓库名和分支名是否正确。
• 上传卡死不动：可能是网络问题，GitHub在国内访问不稳定，可以尝试使用SM.MS图床或七牛云。

五、总结

如果你想省去配置的麻烦，也可以直接使用SM.MS图床（无需额外安装PicGo，在MarkText的偏好设置中直接选择SM.MS即可），只是免费版有单张5MB的大小限制。无论如何，配置好图床之后，你的Markdown写作效率会提升一个档次。