swagger: '2.0' info: version: 0.0.0 title: title description: description with **markdown** format tags: - name: Admin description: tag with **markdown** - name: Xss description: tag with **markdown** paths: /test: get: description: description with **markdown** format summary: a summary with **markdown** format responses: 200: description: a description with **markdown** format schema: $ref: '#/definitions/User' post: description: summary: consumes: - produces: - tags: - Admin tasks parameters: - in: query name: foo type: string - in: query name: reg type: string responses: 200: description: nothing definitions: User: description: also with **markdown** properties: name: description: prop with **markdown** type: string email: $ref: '#/definitions/Email' Email: description: type: string format: email example: