我入閣前，都是用API Blueprint。雖然跟Swagger一樣，都可以同時容納綱要描述、範例資料及互動流程，但當你用Markdown的時候，你就有一種在寫文件的感覺，因此你會自然覺得只是寫機器描述不夠，還要多寫一些文字，而且附圖很容易，就把圖都裝進來，因此到最後仍然是機器可讀的一份描述檔，但在寫作的過程中，你會自然把這三個寫上去，因為Markdown主要是人跟人間交換的一分文件。
我入閣前，都是用API Blueprint。雖然跟Swagger一樣，都可以同時容納綱要描述、範例資料及互動流程，但當你用Markdown的時候，你就有一種在寫文件的感覺，因此你會自然覺得只是寫機器描述不夠，還要多寫一些文字，而且附圖很容易，就把圖都裝進來，因此到最後仍然是機器可讀的一份描述檔，但在寫作的過程中，你會自然把這三個寫上去，因為Markdown主要是人跟人間交換的一分文件。