Enable Automatic Image Upload in Typora with Plugins and Built‑in Options

Overview

Typora is a lightweight, efficient, and elegant Markdown editor that provides a live preview experience. Earlier versions lacked built‑in image‑hosting support, requiring third‑party plugins, but recent updates now include native image‑upload functionality.

1. Automatic Upload via Third‑Party Plugin

The plugin, developed by Thobian, works on Windows and supports GitHub, Qiniu, Alibaba Cloud, Gitee and other services.

After installing the plugin, dragging an image into the editor automatically uploads it and shows a green notification.

Installation

Typora version: 0.9.68 (Windows x86). Download the installer from https://typora.io/windows/typora-update-ia32-0320.exe and install to D:\Program Files\Typora (or another directory).

Steps:

Download the plugin code from https://github.com/Thobian/typora-plugins-win-img.

Copy the files window.html and plugins.

Paste them into the resources\app folder of the Typora installation.

Restart Typora.

Configuration

Edit plugins/image/upload.js to choose the target image host.

Upload to GitHub (recommended)

Create a personal access token with minimal repo.public_repo permission at https://github.com/settings/tokens and configure:

$.image.init({
    target:'github',
    quality:1,
    github:{
        Token:'YOUR_TOKEN',
        CommitterName:'YOUR_NAME',
        CommitterEmail:'YOUR_EMAIL',
        Repository:'YOUR_USER/YOUR_REPO',
        Filepath:'typora',
        jsDelivrCND:false
    }
});

Upload to Self‑Hosted Server

Set the upload URL and optional token header to protect the endpoint:

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

Upload to Tencent Cloud OSS

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

Upload to Alibaba Cloud OSS

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

Upload to Qiniu Cloud

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

Upload to Gitee

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

If you encounter issues, check the plugin's GitHub issue page: https://github.com/Thobian/typora-plugins-win-img/issues.

2. Built‑in Typora Upload Feature (Windows Only)

Update Typora to the latest version (e.g., 0.9.86). In File → Preferences → Image , enable the image‑upload option.

Typora uses PicGo‑Core for uploading. Install PicGo‑Core, then configure a token for the chosen image‑hosting service (e.g., SM.MS).

SM.MS Configuration

Register or log in at https://sm.ms, generate a token, and edit Typora’s configuration file ( picBed section) to include:

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

Restart Typora after saving.

Result

Both the plugin method and the native upload feature allow drag‑and‑drop image uploading, with the plugin offering more host options on Windows, while the built‑in method provides a smoother experience without extra clicks. Mac users can combine Typora with iPic for similar functionality.