Swagger生成Markdown文档

前提条件

1、 本地安装node.js，或者解压安装包

配置环境变量→ 任意路径输入CMD
配置环境变量→ 解压路径输入CMD

2、npm换源（不然下载仓库有可能报错）

npm config get registry                                                  查看源

npm config set registry https://registry.npmmirror.com                   换源
npm config set sass_binary_site https://npmmirror.com/mirrors/node-sass  node-sass有可能要单独配置

参考
NPM 如何换源？
node-sass配置淘宝镜像仓库不生效解决办法

3、高版本可能不兼容，降低npm版本

降低npm版本到6
npm install ---global npm@6

---

swagger-markdown 安装使用

https://github.com/syroegkin/swagger-markdown
https://www.npmjs.com/package/swagger-markdown

Installation

npm install -g swagger-markdown

Usage

swagger-markdown -i D:test\swagger.yaml