但是沒有人寫JSON跟XML的時候，會覺得這是寫給人看，因為這樣的關係，雖然OAS裡面可以容納資料、圖例及互動流程的地方，大家不會一下子想到那邊去，結果是常常那個地方是空的，好比像API的要求，好比一個寫入好了，其實可以附範例資料的東西，甚至裡面要用超連結或內嵌圖片的方式放進去在說明欄，也沒有不可以，因為不是Markdown，大部分的人不會往這個方向想。
但是沒有人寫JSON跟XML的時候，會覺得這是寫給人看，因為這樣的關係，雖然OAS裡面可以容納資料、圖例及互動流程的地方，大家不會一下子想到那邊去，結果是常常那個地方是空的，好比像API的要求，好比一個寫入好了，其實可以附範例資料的東西，甚至裡面要用超連結或內嵌圖片的方式放進去在說明欄，也沒有不可以，因為不是Markdown，大部分的人不會往這個方向想。