swagger转md或其他文档

问题描述：

很多开发接入了swagger插件生成了对应的接口页面。但是每次查看接口的时候需要后端同学开启服务查看对应的swagger接口页面。所以我们想到将每次生成的swagger直接转换成word、md或者其他格式。

解决方案

1、打开对应的swagger页面，点击项目名称下方的链接。

打开链接会是一个内容为json格式的页面。将页面另存为json。

2、解析json文件为对应的文档

这里解析直接采用的yapi生成对应的模板；在yapi项目中直接新建项目，导入刚刚保存的json。就会生成新的swagger对应的接口项目。然后导出时选择自己需要的格式。

导出以后就是离线本地的漂亮的接口文档啦。