How do I get markdown to work in Swagger model descriptions?
<p>I am trying to add extra information to model items in Swagger. The documentation says that GFM syntax can be used in description fields but this is not working in all places.</p>

<p>Here is a minimal dummy example of the problem:</p>

<pre><code>swagger: '2.0'
info:
  title: Example API
  description: (1) This is the API description containing some *rich* **text**
  version: "1.0.0"
paths:
  /products:
    get:
      summary: Product Types
      description: (2) This is the path description also containing some *rich* **text**

      responses:
        200:
          description: (3) This is a response description also containing some *rich* **text**
          schema:
            type: array
            items:
              $ref: '#/definitions/Product'

definitions:
  Product:
    description: (4) This is a model description where *rich* **text** does not work
    type: object
    properties:
      product_id:
        type: string
        description: (5) This is a field description where *rich* **text** does not work
</code></pre>

<p><a href="https://i.stack.imgur.com/m5kAD.png" rel="nofollow noreferrer"><img src="https://i.stack.imgur.com/m5kAD.png" alt="Output from Swagger editor"></a></p>

<p>The <a href="http://swagger.io/specification/#schemaObject" rel="nofollow noreferrer">schema object documentation</a> says that I should be able to use Markdown in the place marked as (4) above but doesn't say anything about place (5).</p>

<p>I want to add Markdown to either of the two places in the Model section. How can I get this to work?</p>