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 install ---global npm@6   降低npm版本到6

---

swagger-markdown 安装使用

Installation

npm install -g swagger-markdown

Usage

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

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