markdown编辑器typora本地图片上传到本身的服务器

typora是windows平台下最受欢迎的markdown书写工具和查看工具，本篇文章将会介绍如何在typora平台使用java脚本程序自动上传本地图片到本身的服务器，从而让markdown文章中的图片“一次书写，到处可见”，免去老是须要转换图片的麻烦。

1、从何处下手

1.typora设置

老版本的typora不支持图片上传，因此首先要升级typora，而后打开 文件->偏好设置，点击图像tab，能够看到以下选项

插入图片时选择只对本地图片执行上传图片操做，上传服务选择Custom Command选项，就可使用自定义上传功能了，命令一栏里填写本地上传脚本地址或者命令，点击“验证图片上传选项”，能够验证上传功能是否正常。

2.如何设计上传脚本

上传脚本可使用任意语言实现，惋惜我只会java，因此这里使用java实现（笑）。可是这里有一个前提，那就是必须知足typora对上传图片的API要求，点击命令下面的“说明”按钮，跳转网页https://support.typora.io/Upload-Image，这里直接查看custom那一栏，地址：https://support.typora.io/Upload-Image/#custom，就能够看到它对脚本实现的具体要求了：

翻译一下，它的大概意思是，设计的脚本必须知足几个要求：

1. 脚本图片输入方法是这般形式：脚本地址 图片1绝对路径 图片2绝对路径
2. 脚本上传完图片以后将图片的完整url打印到控制台，typora就会取倒数N行字符串做为图片的url地址（有几张图片就取倒数几行），并自动插入到markdown文件中
3. 能够用测试按钮测试上传功能。

整个过程很是简单。

2、JAVA脚本实现

其实所谓的java脚本实现就是个main方法的事儿，这里根据咱们的需求，归拢下须要的组件

1. 最重要的确定是http请求组件，这里使用hutool工具包中的http请求工具，将会使用它实现获取token、上传图片功能
2. 没有spring不舒服，这里要引入spring组件实现Bean的管理，不使用spring都不会写代码了，唉
3. 序列化工具使用jackson
4. 使用lombok简化开发
5. 使用slf4j+logback做为日志框架

捡着重要的说几处吧

1.脚本中如何使用spring

你们都知道在springboot中使用spring很是简单，脱离了springboot还有谁记得怎么用spring吗，哈哈，我也忘了，因此我百度了下

AnnotationConfigApplicationContext ctx = new AnnotationConfigApplicationContext();
ctx.register(Config.class);
ctx.refresh();

没错，就这么简单，以后就可使用getBean获取对象了。UploadService service = ctx.getBean(DefaultUploadServiceImpl.class);

2.使用hutool上传图片

首先，须要服务端的上传图片接口，这个就不说了吧，算了仍是说下吧，形式上就是这个样子

@PostMapping("/upload")
@ResponseBody
public UploadResult upload(@RequestParam(value = "file", required = false) MultipartFile file,
                           HttpServletRequest request) throws IOException {
    ...
}

脚本要使用hutool调用这个接口上传图片，上传方法代码以下

String body = HttpRequest
    .post(configProperties.getUploadUrl())
    .form("file", new File(filePath))
    .cookie(new HttpCookie(token.getKey(), token.getValue()))
    .execute()
    .body();
UploadResult uploadResult = objectMapper.readValue(body, UploadResult.class);

完美。

可是要注意，上传图片的接口每每须要登陆才能够调用，不然八成没有权限。因此在调用该接口以前须要先调用登陆接口获取token，这里就不赘述了。

3.注意事项

必定要将图片的完整路径分行打印到控制台日志的最后几行，这是知足typora图片上传脚本的硬性条件。

3、源代码

https://gitee.com/kdyzm/typora-upload-plugin

该项目使用mavan管理依赖，使用命令mvn clean package打包以后，获得可执行jar包便可使用，须要注意的是，该项目是为开源博客系统https://gitee.com/mtons/mblog量身打造的上传脚本，若是不是使用这个博客系统，就要本身修改源代码了。

另外，欢迎关注个人博客：https://blog.kdyzm.cn

4、效果演示

下面开始演示截图以后复制到typora编辑器以后自动上传截图到远端服务器的过程：

能够看到，剪切板中的图片一旦粘贴到markdown编辑器中，会调用脚本上传图片并将返回结果中的图片连接帮咱们插入到编辑器中。

完美。