It is possible to write a description for an OpenAPI document in Markdown. This comes with limitations. For example, tables are not rendered correctly.
The best practice is to define a description in a separate document, such as a Quickstart document.