【经验总结】将markdown文档转换为word（swagger导出word）

工具准备：

• 任意markdown编辑器，以typora为例
• pandoc，官方下载地址

思路整理：

1. 从swagger提取离线md文档
2. 将md文档转换为word格式

操作步骤：

一、安装pandoc

（markdown编辑器安装略）

1. 前往官网进行下载，下载地址：https://www.pandoc.org/installing.html#windows
2. 双击下载到的文件pandoc-3.1.2-windows-x86_64.msi，

3. 打开控制台输入指令pandoc --version验证安装成功即可

二、配置pandoc样式文件

1. 进入typora设置页面中

2. 配置word样式文件即可。

进阶：自定义样式文件可以参考官方指南：https://pandoc.org/MANUAL.html#option–reference-doc

三、从swagger文档中提取离线md文档

进入任意swagger-ui页面中，找到离线文档，并拷贝。（也有swagger-ui搭配直接支持下载word文档，直接下载即可）

四、将md转换为word

打开md文档，选择导出，选择word，即可获得word文档