Employ markdown from improved OpenAPI definitions

[fmigneault]

There are multiple places where Markdown notation could be used to highlight code blocks or links in the OpenAPI definition.

A few examples for