Using Markdown for descriptions

Postman supports Markdown as a way to style text descriptions for requests, collections, and folderswithin collections. You can even embed screenshots and other images for more descriptive flair.

Review reference for using Markdown in API documentation.

Postman renders this markdown in the following places:

In the request builder, the request description can be styled with markdown.

The collections details view can be styled with markdown in the descriptions for collections and folders.

For either public or internal API documentation, automatically generated API descriptions will be styled beautifully and precisely with markdown.

Descriptions for request attributes

The description column in the data editor makes your requests easier to understand. You can add comments and details for each of your query parameters, path variables, headers, and body (form-data and urlencoded) - all from right within the Postman app.

For example, specify if an element is required or optional, indicate the accepted data type, or use alternative terminology to provide additional clarification for developers who are working with your requests.

For Postman users publishing internal or public API documentation, these descriptions are displayed in the automatically generated documentation for that collection.

Note: Descriptions for path variables and URL params are currently NOT shown in the documentation.

You can hide and show the value and description column in the data editor by clicking on the ellipsis (…) in the top right corner of the editor, and unchecking the columns that you want to hide.

Note: Descriptions are metadata for a request and are NOT sent with your HTTP request. This reminder is displayed when you mouse over the title of the description column.