跳到主要内容

3.10 导出离线文档

温馨提醒

knife4j 版本>2.0.1 使用此规则,离线文档导出功能目前暂时未提供导出PDF,推荐大家使用一款MD的渲染软件(Typora)进行导出

在以前的开发人员使用Swagger的时候,希望Swagger能够导出一份精细的文档,不管是集成何种方式,使用方法都是比较繁琐的,而且导出的文档效果也不尽如人意

为了解决这个问题,Knife4j在前端界面直接集成了两种导出Swagger文档的方式,主要是导出Markdown和离线Html

对于使用者来说,能把过程简单化是最好的,而Knfie4j提供的导出功能就是如此简单

在前端Ui界面中的文档管理 => 离线文档 菜单栏,我们点击后可以看到如下界面:

特别说明:

  • markdown:导出当前逻辑分组下所有接口的Markdown格式的文档
  • Html:导出当前逻辑分组下所有接口的Html格式的文档
  • Word:导出当前逻辑分组下所有接口的Word格式的文档(自2.0.5版本开始)
  • OpenAPI:导出当前逻辑分组下的原始OpenAPI的规范json结构(自2.0.6版本开始)
  • PDF:未实现

直接点击下载Markdown,Knife4j就会为我们生成一份精细的MD文档,效果图如下:

导出的Html效果,如下图: