## 一、概述 PI Blueprint 是一套基于 markdown 的 API 描述語言規范，如果你按照它的規范來編寫你的 API 文檔的話，你就可以享受到配套的工具服務了； 它基于markdown語法，跟knife4j(swagger）是競爭關系； [aglio](https://link.jianshu.com/?t=https://github.com/danielgtaylor/aglio)是一個可以根據 api-blueprint 的文檔生成靜態 HTML 頁面的工具。 ## 二、安裝 ``` npm install -g aglio aglio -i foo.md -o bar.html ``` ## 二、實戰 ``` FORMAT: 1A # Example API hello world ## 消息 [/messages] ### 獲取消息 [GET] + Response 200 (application/json) { "hello": "world" } ``` 生成html文檔： ``` aglio -i hello.md -o hello.html ``` 啟動服務： ``` api-mock ./hello.md --port 3000 ``` 訪問`localhost:3000/message` 不但有了漂亮的 html 文檔, 也有了一個方便對接的 mock 服務.；