工具准备:
- 任意markdown编辑器,以typora为例
- pandoc,官方下载地址
思路整理:
- 从swagger提取离线md文档
- 将md文档转换为word格式
操作步骤:
一、安装pandoc
(markdown编辑器安装略)
- 前往官网进行下载,下载地址:https://www.pandoc.org/installing.html#windows
- 双击下载到的文件pandoc-3.1.2-windows-x86_64.msi,
- 打开控制台输入指令
pandoc --version
验证安装成功即可
二、配置pandoc样式文件
- 进入typora设置页面中
- 配置word样式文件即可。
进阶:自定义样式文件可以参考官方指南:https://pandoc.org/MANUAL.html#option–reference-doc
三、从swagger文档中提取离线md文档
进入任意swagger-ui页面中,找到离线文档,并拷贝。(也有swagger-ui搭配直接支持下载word文档,直接下载即可)
四、将md转换为word
打开md文档,选择导出,选择word,即可获得word文档