环境配置：SpringBoot、SpringFox、Swagger2Markup、Asciidoctor 和 Maven

使用 Swagger2Markup 将 Swagger.json 转换成 Markdown:

Swagger2MarkupConfig config = new Swagger2MarkupConfigBuilder()
                    .withMarkupLanguage(MarkupLanguage.MARKDOWN)
                    .withOutputLanguage(Language.ZH)
                    .withPathsGroupedBy(GroupBy.TAGS)
                    .build();

Swagger2MarkupConverter converter = Swagger2MarkupConverter.from(localSwaggerFile).withConfig(config).build();
converter.toFile(outputFile);

Petstore API Description

版本 : 1.0.0

名字 : leongfeng 邮箱 : leongfeng@163.com

许可证 : Apache 2.0 许可网址 : http://www.apache.org/licenses/LICENSE-2.0.html 服务条款 : null

域名 : localhost 基础路径 : /

• Index : Index operation
• Pets : Operations about pets

Index operation

GET /

• application/json

• */*

Operations about pets

POST /pets

• application/json

• */*

PUT /pets

• application/json

• */*

GET /pets/{petId}

Returns a pet when ID < 10. ID > 10 or nonintegers will simulate API error conditions

• application/json

• */*

DELETE /pets/{petId}

Delete a pet from the store

• application/json

• */*