How to Enable Automatic Image Upload in Typora with Plugins and Built‑in Support

Automatic image upload via third‑party plugin (Windows only)

The open‑source plugin by Thobian adds drag‑and‑drop image uploading to Typora on Windows. Supported back‑ends include GitHub, self‑hosted servers, Tencent Cloud OSS, Alibaba Cloud OSS, Qiniu, and Gitee.

Installation

Download the plugin source (e.g., reply "md插件" to the WeChat public account).

Copy window.html and the plugins folder.

Paste them into the Typora resources directory, e.g. D:\Program Files\Typora\resources\app (or your custom install path).

Restart Typora.

Configuration

Edit plugins/image/upload.js and call $.image.init() with the desired target. Below are concrete examples.

GitHub (recommended)

$.image.init({
    target: 'github',
    quality: 1,
    github: {
        Token: 'YOUR_GITHUB_TOKEN',
        CommitterName: 'your_nickname',
        CommitterEmail: '[email protected]',
        Repository: 'YourUser/typora-plugins-win-img',
        Filepath: 'typora',
        jsDelivrCND: false
    }
});

Self‑hosted server

$.image.init({
    target: 'self',
    self: {
        url: "https://your-server.com/upload",
        headers: { token: "YOUR_TOKEN" }
    }
});

Tencent Cloud OSS

$.image.init({
    target: 'tencent',
    tencent: {
        Bucket: 'your-bucket',
        SecretId: 'YOUR_SECRET_ID',
        SecretKey: 'YOUR_SECRET_KEY',
        Region: 'ap-beijing',
        folder: 'typora'
    }
});

Alibaba Cloud OSS

$.image.init({
    target: 'aliyun',
    aliyun: {
        SecretId: 'YOUR_ACCESS_KEY_ID',
        SecretKey: 'YOUR_ACCESS_KEY_SECRET',
        Folder: 'typora',
        BucketDomain: 'http://your-bucket.oss-cn-beijing.aliyuncs.com/'
    }
});

Qiniu

$.image.init({
    target: 'qiniu',
    qiniu: {
        UploadDomain: 'https://up.qiniu.com',
        AccessDomain: 'http://your-bucket.qiniu.com/',
        AccessKey: 'YOUR_ACCESS_KEY',
        SecretKey: 'YOUR_SECRET_KEY',
        Folder: 'typora',
        policyText: { scope: "your-bucket", deadline: 225093916800 }
    }
});

Gitee

$.image.init({
    target: 'gitee',
    gitee: {
        message: "From: https://github.com/Thobian",
        branch: "master",
        token: "YOUR_GITEE_TOKEN",
        userName: "your_username",
        repositorie: "typora",
        Folder: "image",
        BucketDomain: "https://gitee.com/api/v5/repos/"
    }
});

Built‑in Typora image upload (Windows only)

Typora version 0.9.86 or later includes a native image‑upload feature. Enable it via File → Preferences → Image Insert → Image Upload . Typora relies on the PicGo‑Core utility for the actual upload.

PicGo‑Core installation

Download the PicGo‑Core binary from the official Typora Windows page, install it, and ensure the executable is in your system PATH.

Example configuration: SM.MS

SM.MS provides free permanent image hosting with HTTPS links. After registering at https://sm.ms and generating a token, create a PicGo configuration file (e.g., picgo.config.json) with the following content:

{
  "picBed": {
    "uploader": "smms",
    "smms": { "token": "YOUR_SMMS_TOKEN" }
  },
  "picgoPlugins": {}
}

Restart Typora to apply the changes.

Comparison and notes

The third‑party plugin offers more back‑ends and slightly faster uploads but works only on Windows and requires manual installation of the plugin files.

The built‑in feature also requires Windows, but it needs no extra files; images are uploaded immediately after dragging.

Mac users can achieve similar functionality by pairing Typora with iPic (not covered here).

For troubleshooting, consult the plugin’s GitHub issue tracker at https://github.com/Thobian/typora-plugins-win-img/issues.