[swagger] swagger to markdown

swagger-editor

[root@node1 swagger-editor-3.17.0]# http-server -p 8021

ui 导出yaml文件

swagger-markdown

Installation

npm install -g swagger-markdown

Usage
swagger-markdown [-h] [-v] -i [-o] [--skip-info]

Options:
  -h, --help      Show this help message and exit.
  -v, --version   Show program's version number and exit.
  -i , --input    Path to the swagger yaml file
  -o , --output   Path to the resulting md file
  --skip-info     Skip the title, description, version etc, whatever is in the info block.

Npx (requires no installation)

npx swagger-markdown -i ./basic-auth.yaml

Example

swagger-markdown -i path/to/swagger/file.yaml

swagger-markdown -i .\test.ymal -o test.md

指导： https://www.jianshu.com/p/53274d7d7512