https://github.com/wdullaer/raml2html-slate-theme/issues/72

simple.raml

#%RAML 1.0
title: API with Types
types: # global type definitions that can be reused throughout this API
  User: # define type named `User`
    type: object
    properties:
      firstName: string
      lastName:  string
      age:
        type: integer
        minimum: 0
        maximum: 125
/users/{id}:
  get:
    queryParameters: 
      foo:
        description: |
          blah, blah, blah

          this is a longer description.
          * 1st item
          * 2nd item
        type: string
        required: false
    responses:
      200:
        body:
          application/json:
            type: User # reference to global type definition