Typora · 实操配置指引

分享 Typora 文档,
让图片一起跟过去。

Markdown 本身只保存图片路径。如果文档里只有本地电脑的相对路径,文件一旦发给别人,图片就会变成红叉或空白。配好图床,图片就会自动替换成随时可看的 HTTPS 公开外链。

SilentFlow 是按周期透明计费的图片托管服务。体验版 ¥6/月、标准版 ¥58/年、专业版 ¥128/年;支付宝付款后约 1 分钟系统自动开通,密钥直发邮箱。详细配额请以价格方案为准。图片外链为公开访问,原图请始终保留本地备份。

1

完成 PicGo 的首次上传

先去 客户端页面下载 PicGo 桌面端,并准备好您的 SilentFlow API Key 密钥。

  1. 下载并打开 PicGo 桌面端,在左侧点击「插件设置」,在搜索框中输入 silentflow,点击安装插件。
  2. 安装完成后,进入「图床设置 → SilentFlow」:
    • API URL:填写 https://slnt.dev
    • Secret Key:粘贴您收到的专属上传密钥(以 sk_live_... 开头)
  3. 点击确定保存,并将 SilentFlow 设为默认图床。建议先在 PicGo 的上传区拖入一张不含隐私的测试截图,确认能返回可打开的链接,再连接编辑器。

提示:当前公开 npm 插件版本为 1.0.5。您的专属密钥请妥善保管,切勿发送给他人或提交到公开代码仓库。

2

在 Typora 中验证上传服务

  1. 打开 Typora,进入顶部菜单「格式 / 偏好设置 → 图像」,在上传服务下拉菜单中选择 PicGo (app)。
  2. 系统适配注意:macOS 确保 PicGo 在后台运行即可;Windows 与 Linux 用户如果报错找不到程序,需在下方填入 PicGo 的本地安装路径(如 C:...PicGo.exe)。
  3. 在 PicGo 的 Server 设置中确认内置服务处于开启状态,端口保持默认的 36677。
  4. 点击 Typora 设置界面的「验证图片上传选项」按钮,确认弹窗显示上传成功并返回可访问的外链。

提示:PicGo (app) 是桌面客户端,PicGo-Core 是无界面命令行。本教程推荐使用桌面 app,直观省心。详见 Typora 官方上传文档 ↗。

3

先单图测试,再开启全局自动上传

  1. 新建一篇测试文档,插入一张本地截图。
  2. 右键点击该图片,选择「上传图片」,确认图片下方的地址变成了以 https://... 开头的公网链接。
  3. 验证通过后,在 Typora 图像偏好设置中将「插入图片时」勾选为「上传图片」。
  4. 把生成的图片链接发到另一台设备或在浏览器无痕窗口打开,验证读者是否能清晰看见图片。

已有旧文档的本地图片如何处理?

先做好旧文档和本地图片文件夹的完整备份。Typora 支持在菜单中批量上传文档中的本地图片,建议先在一篇副本上验证测试,再逐篇处理。大批量迁移前,可先用我们的免费检查工具统计图片分布。

如果验证提示失败:先阅读 Typora 弹出的错误日志。如果 PicGo 单独能上传但 Typora 验证失败,优先检查上传器类型、Windows 路径,以及 PicGo 的 36677 服务端口是否开启。