typora-upload

项目地址： https://github.com/TyrantLucifer/typora-upload

欢迎大家的⭐⭐⭐

基于 typora 图片上传协议开发的笔记图片上传插件

痛点

相信很多程序员都有着使用 markdown 语法记录自己笔记的习惯，对于在笔记中插入图片有利于我们后期维护笔记和回复笔记，图文并茂可以更快的让我们 get 到自己的点。可问题随之而来：

图片保存在本地容易丢失，在更换电脑之后，资料全部清零的感觉很不好受
图片保存在云端会产生费用成本，目前各家图床供应商价格不一，且各家平台对接 api 不一致
市面上的笔记保存服务商有很多，将图片保存到他们服务器下也可以，但百分之 90 服务商会设置防盗链，你的图片只能在笔记服务商的软件环境下才有效，依然有跑路的风险

基于以上几点的需求，我们可以得到这么几个关键词：云端 速度快 图片可复用 无跑路风险

笔记工具的选择

大家或多或少都在使用各家笔记的服务商来作为自己的平台保存经验，比如知名的有：为知笔记 印象笔记 notion等，无一例外，这些笔记提供商都有一个通病，那就是本身笔记自带的编辑器并不好用(个人看法，不代表全部)。

大多数人更喜欢市面上免费许久(严谨一点说现在正式版已经收费，过去的测试 beta 版本不收费)的Typora情有独钟，包括我在内，几乎无人能超越，结合这几点，我总结出了笔记记录的最佳实践：笔记服务商提供数据保存 + Typora 编辑笔记 + 图片保存在云端(oss, github etc...)

萝卜青菜各有所爱，这只是我个人看法，不代表全部，求别杠

使用

目前Typora已经支持自定义脚本上传图片，所以我们需要开发一个小小的上传工具即可，在这里我选择了使用 Python 进行开发，对接不同的云存储平台去上传图片，目前小插件仅支持 github 、oss ，后续如果有新的需求会持续开发。

    usage: typora-upload [-h] [-u file_path] [-s storage] [-i storage] [-v]

    The typora image upload plugin based Python.

optional arguments:
  -h, --help            show this help message and exit
  -u file_path, --upload file_path
                        upload image file
  -s storage, --storage storage
                        storage type
  -i storage, --init storage
                        init storage config
  -v, --version         display version

安装

源码安装

git clone https://github.com/TyrantLucifer/typora-upload.git
cd typora-upload
python(python3) setup.py install

pip 安装

pip(pip3) install typora-upload

配置云存储参数

注！！！：第一次安装之后此步骤必须进行，默认存储云盘会设置为 oss

typora-upload --init 云存储类型

oss

参数	备注
access_key_id	oss access_key_id ，oss 密钥 id
access_key_secret	oss access_key_secret ，oss 密钥
bucket_name	oss bucket_name ，oss 存储桶名称
endpoint	oss endpoint ，oss 存储地区
path_prefix	image upload path prefix, do not end with `/`, for example, if you want to upload image to`/image`, this parameter should be set to `image`，上传到的 oss 路径
domain_name	oss public domain address ，do not start with `http://` or `https://`，oss 公网访问域名，不带 http://或 https://协议头

github

参数	备注
user	github username ，github 用户名
repo	github repository name ，github 仓库名称
path_prefix	image upload path prefix, do not end with `/`, for example, if you want to upload image to`/image`, this parameter should be set to `image`，上传到 github 仓库的路径
token	github api token

配置 typora

打开 typora 的文件 -> 偏好设置 -> 图像，在上传服务设定里选择Custom Command，命令中填入typora-upload -u

自荐一个我开发的小工具 typora-upload，专为 markdown 图片上传而生，提升生产力

typora-upload

痛点

笔记工具的选择

使用

安装

配置云存储参数

oss

github

配置 typora

效果展示