Swagger接口导出word、pdf文档

swagger接口文档导出为word、pdf文档有几种方式

1. 在线转换

在线swagger转word文档|swagger导出word文档 - Kalvin在线工具

把swagger中的json串导入到此网站就行

2. maven插件转换

新建一个maven工程；

pom代码如下：

 
        
            io.springfox
            springfox-swagger2
            2.8.0
        
        
            io.springfox
            springfox-swagger-ui
            2.8.0
        

        
        
            io.github.swagger2markup
            swagger2markup
            1.3.4
        
    

    
        
            
                io.github.swagger2markup
                swagger2markup-maven-plugin
                1.2.0
                
                    
                    C:UsershuangqingwenDesktopswagger.json
                    src/docs/asciidoc/generated
                    
                        
                        ASCIIDOC
                    
                
            

            
                org.asciidoctor
                asciidoctor-maven-plugin
                1.5.3
                
                
                    
                        org.asciidoctor
                        asciidoctorj-pdf
                        1.5.0-alpha.10.1
                    
                    
                        org.jruby
                        jruby-complete
                        1.7.21
                    
                
                
                
                    src/docs/asciidoc/generated
                    coderay
                    
                        left
                    
                
                
                
                    
                        output-html
                        generate-resources
                        
                            process-asciidoc
                        
                        
                            html5
                            src/docs/asciidoc/html
                        
                    

                    
                        output-pdf
                        generate-resources
                        
                            process-asciidoc
                        
                        
                            pdf
                            src/docs/asciidoc/pdf
                        
                    

                
            
        
    

然后执行maven命令：

mvn swagger2markup:convertSwagger2markup

mvn generate-resources

然后就会在对应的目录下生成word、pdf文件

注意：maven插件中asciidoctor导出pdf的时候中文会可能缺失，原因可能是因为该插件的作者是外国的，没有怎么适配到中文，所以大家如果想要pdf的话可以配置一下字体；又或者用word文档，word文档是不会缺失中文的，最后再用word文档转换成pdf。