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

教程简介

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

• Typora：常用的markdown编辑器

• PicGo：可选Typora内置，也可以指定自己安装的

• Nodejs（可选）：用于给PicGo-Core (command line)安装自动重命名插件，如果使用PicGo图形化界面，则不需要Nodejs

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

准备工作

必需的工具

• Typora：如果你还没有，可以参考这篇👇

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

• 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}{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​