springboot2使用Swagger2Markup实现导出API文档(3)

参考文档：使用Swagger2Markup实现导出API文档-腾讯云开发者社区-腾讯云

github：GitHub - Swagger2Markup/swagger2markup: A Swagger to AsciiDoc or Markdown converter to simplify the generation of an up-to-date RESTful API documentation by combining documentation that’s been hand-written with auto-generated API documentation.

码云：https://gitee.com/darkone/springboot2-swagger2markup

======================代码===================

1、pom.xml依赖

2、配置文件

3、swagger核心配置类

4、entity类

5、返回结果类

6、controller类

7、swagger2Markup生成文档类

8、启动类

9、junit测试类

===================演示效果=================

1、启动项目：运行SwaggerApplication即可（参考第8步）

2、访问swagger2-ui：http://localhost:8001/springboot2-swagger/swagger-ui.html#/，如下图：

================基于main方法运行（方法一）===================

1、运行main方法，如下图：

生成如下图所示文档文件：

2、eclipse中maven执行命令：asciidoctor:process-asciidoc或mvn asciidoctor:process-asciidoc

=====================基于junit运行（方法二）======================

1、eclipse中maven执行命令：test asciidoctor:process-asciidoc或mvn asciidoctor:process-asciidoc

=============================结果（演示）=======================

1、生成html文档

2、html文档如下图：