One of the top requests we get from API providers in Mashape is to add a section where they can go beyond just plain text when providing more in-depth information about their APIs (e.g. introduction, usage guidelines, sample codes, etc). This requires a level of formatting that simply cannot be achieved with just plain text.
Also, having information in one place, as opposed to having several browser tabs open to read through the API usage information, can be quite a time-saver.
We have added a “Getting Started” section for your APIs in Mashape. It supports GitHub Flavored Markdown