Typora图片解决方案：Typora + PicGo + 重命名插件使用指南

教程简介

本教程会逐步指导你完成 Typora 自动上传图片的方案。
​使用工具​：

• Typora：常用的 markdown 编辑器
• PicGo：可选 Typora 内置，也可以指定自己安装的
• Nodejs（可选）：用于给 PicGo-Core (command line)安装自动重命名插件，如果使用 PicGo 图形化界面，则不需要 Nodejs

​适用场景​：个人本地知识库等。

准备工作

必需的工具

• Typora：如果你还没有，可以参考这篇👇
  Typora的安装（当然不是普通版本啦） | 🌹Dominic的二手博客🌹
• PicGo：可选 Typora 内置（本文重点），也可以指定自己安装的

可选的工具

• Nodejs：如果你选择 Typora 内置的 PicGo，且需要自动重命名插件，那就需要安装 Nodejs

配置步骤

1. 安装 Typora 内置 PicGo

打开 Typora 偏好设置，图像 -> 上传服务设定，选择 PicGo-Core(command line)，点击​下载或更新​，该过程会自动完成，完成后点击​打开配置文件​。

​

​

2. 安装自动重命名插件

在 PicGo 中使用 ​picgo-plugin-rename-file​ 插件，自定义上传图片的文件名格式，能避免云存储桶中出现文件重名导致上传失败的情况。

1. 打开终端 cmd，切换到 PicGo-Core 安装目录
   通常 PicGo-Core 被安装在 Typora 的安装文件夹内，需要先切换到此目录。
   Windows 默认路径：

   cd C:\Users\你的用户名\AppData\Roaming\Typora\picgo\win64\
   

   （将 ​你的用户名​ 替换为实际用户名）

2. 执行安装命令

   .\picgo.exe install rename-file
   

   注意： 安装插件需要电脑已安装 Node.js 环境。如果没有安装，请先访问 nodejs.org 下载安装。具体安装步骤本文档不另外说明。

3. 修改配置文件
   安装完成后，需要编辑 PicGo 的配置文件 ​config.json​ 来启用插件并设置命名规则。

3. 修改配置

在第 1 步打开的 ​config.json​ 中添加以下内容，本文提供阿里云 oss 存储桶和 GitHub 图床的配置方案：

阿里云 OSS 存储桶

{
    "picBed": {
        "uploader": "aliyun",
        "aliyun": {
        "accessKeyId": "xxxxxx",
        "accessKeySecret": "xxxxxx",
        "bucket": "xxxxxx",		// Bucket名称
        "area": "oss-cn-xxxxxx",	// OSS管理界面的EndPoint（地域节点的第一部分）
        "path": "typora/",		//二级路径，置空则上传到根目录
        "customUrl": "https://xxxxxx.oss-cn-xxxxxx.aliyuncs.com",  //// OSS管理界面Bucket域名，加上了https
        "options": ""
        }
    },
	"picgoPlugins": {
        "picgo-plugin-rename-file": true		// 启用重命名插件
    },
    "picgo-plugin-rename-file": {
    	"format": "{y}/{m}/{d}{h}{i}-{rand:3}"    // 重命名插件配置
    }
}

GitHub 图床

{
  "picBed": {
    "current": "github",
    "github": {
      "repo": "你的用户名/你的仓库名",
      "branch": "main",
      "token": "你的 GitHub Token",
      "path": "picgo/",		// 二级路径，置空则上传到根目录
      "customUrl": ""		// 自定义域名，默认的是 https://raw.githubusercontent.com/ ，国内可能无法访问，可使用cloudflare反代
    }
  },
  "picgoPlugins": {
    "github": true,
    "picgo-plugin-rename-file": true   // 启用重命名插件
  },
  "picgo-plugin-rename-file": {
    "format": "{y}/{m}/{d}{h}{i}-{rand:3}"     // 重命名插件配置
  }
}

4. 验证功能

点击​验证图片上传选项​

​

​

成功会获得图片地址，点击访问即可看到图片

​

​

命名占位符详解

插件支持丰富的占位符，你可以自由组合成想要的格式。

占位符	说明	示例输出
​{y}​	4 位年份	​2026​
​{m}​	2 位月份	​02​
​{d}​	2 位日期	​25​
​{h}​	2 位小时（24 小时制）	​14​
​{i}​	2 位分钟	​30​
​{s}​	2 位秒数	​45​
​{timestamp}​	10 位时间戳（秒）	​1677312345​
​{millisecond}​	13 位时间戳（毫秒）	​1677312345123​
​{rand:n}​	n 位随机字符串（字母 + 数字）	​a1b2c3​（当 n=6 时）
​{origin}​	原文件名（不含后缀）	​IMG_001​
​{ext}​	原文件扩展名（含点，如 ​.png​）	​.png​
​{sha1}​	文件内容的 SHA1 哈希值（前 8 位）	​3f7d8a1b​
​{md5}​	文件内容的 MD5 哈希值（前 8 位）	​5d41402a​

常用组合示例：

• ​{y}{m}{d}-{rand:6}​ → ​20260225-a1b2c3.png​
• ​{y}-{m}-{d}_{h}{i}{s}​ → ​2026-02-25_143045.png​
• ​{origin}_{timestamp}​ → ​IMG_001_1677312345.png​
• ​{rand:8}{ext}​ → ​XyZ9876F.png​

👉 查看原文 👈

https://blog.dominickk.top/archives/fY6u3Aoc