Swagger2接口文档.MD文件转Docx

首先说说Markdown(.md文件)

Markdown是一种可以使用普通文本编辑器编写的标记语言,通过简单的标记语法,它可以使普通文本内容具有一定的格式。

Pandoc下载和安装

Pandoc是由[John MacFarlane]开发的[标记语言]转换工具,可实现不同标记语言间的格式转换,堪称该领域中的[瑞士军刀]

下载Pandoc

下面以下载Windows下的pandoc为例:

  • 官网下载链接:https://github.com/jgm/pandoc/releases/tag/2.2
  • 根据自己的操作系统位数下载合适的msi安装包,我下载的是:pandoc-2.2-windows-x86_64.msi

安装pandoc

下载pandoc安装包之后,傻瓜式安装(同意条款下一步,repeat)就可以了。安装完成之后,打开cmd命令行,输入pandoc -v,如果正常显示出类似下面的信息就表明安装成功:

pandoc 2.2
Compiled with pandoc-types 1.17.4.2, texmath 0.10.1.2, skylighting 0.7.0.2
Default user data directory: C:\Users\Administrator\AppData\Roaming\pandoc
Copyright (C) 2006-2018 John MacFarlane
Web:  http://pandoc.org
This is free software; see the source for copying conditions.
There is no warranty, not even for merchantability or fitness
for a particular purpose.

.md转换成.docx

  1. 打开CMD命令行
  2. 将Swagger文档复制到test.md文件中(test为我使用的文件名,根据实际情况修改)
  3. CMD切换至test.md文件所在路径
  4. 执行pandoc test.md -o test.docx 命令
  5. 在test.md同路径找到并打开生成的test.docx文件进行调整字体,间距等
  6. 大功告成

你可能感兴趣的:(Swagger2接口文档.MD文件转Docx)