swagger2markup的使用

Swagger2Markup是一个用于将Swagger API文档转换为Markdown或AsciiDoc格式的工具。它可以帮助开发人员将Swagger API文档转换为可读性更好的格式，以便于文档的编写、分享和维护。

使用Swagger2Markup可以按照以下步骤进行：

1. 添加Swagger2Markup依赖：在项目的构建文件中添加Swagger2Markup的依赖，例如在Maven项目中可以在pom.xml文件中添加以下依赖：

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

2. 配置Swagger API文档：在项目中配置Swagger API文档的地址和相关信息，例如在Spring Boot项目中可以通过在application.properties或application.yml文件中添加以下配置：

springfox.documentation.swagger.v2.path=/v2/api-docs

3. 生成Markdown或AsciiDoc文档：使用Swagger2Markup提供的API将Swagger API文档转换为Markdown或AsciiDoc格式的文档。可以通过编写一个Java类来实现这一步骤，例如：

import io.github.swagger2markup.Swagger2MarkupConverter;

import java.nio.file.Paths;

public class SwaggerToMarkup {
    public static void main(String[] args) throws Exception {
        Swagger2MarkupConverter.from(Paths.get("swagger.json"))
                .build()
                .toFile(Paths.get("output"));
    }
}

其中，`swagger.json`是Swagger API文档的地址，`output`是生成的Markdown或AsciiDoc文档的输出路径。

4. 生成文档：运行上述Java类，即可生成Markdown或AsciiDoc格式的文档。