How to document using Markdown

Postman has created a collection to test Markdown styling inside Postman or in other services that render Markdown. The descriptions in the collection contain Markdown syntax and some of them have links to HTML pages of their rendered version. 

markdown reference

Postman supports Markdown as a way to style text descriptions for requests, collections, and folders in collections. You can even embed screenshots and other images for more descriptive flair. Learn more about where Postman renders Markdown.

example of markdown in collection description

Additional Resources
Case Studies