swagger2markup生成离线的API接口文档

一、背景

swager2只能生成在线的接口文档，有时候我们需要pdf、word的文档。利用swagger2markup可以生成静态的html和pdf文档。

二、步骤

1.  添加swagger2的依赖

<dependency>
   <groupId>io.springfox</groupId>
   <artifactId>springfox-swagger2</artifactId>
   <version>${swagger2.version}</version>
</dependency>
<dependency>
   <groupId>io.springfox</groupId>
   <artifactId>springfox-swagger-ui</artifactId>
   <version>${swagger2.version}</version>
</dependency>

2、添加swagger2markup的依赖

<dependency>
   <groupId>io.github.swagger2markup</groupId>
   <artifactId>swagger2markup</artifactId>
   <version>1.3.1</version>
</dependency>

3. 添加插件的依赖

<plugin>
   <groupId>io.github.swagge