Swidger UI / Swashbuckle响应说明，插入符号无法正确呈现

Question

我在.Net项目中使用Swashbuckle和Swagger UI。我在控制器上使用以下属性。

[SwaggerResponse(HttpStatusCode.OK, "IEnumerable<EmployeeModel>", typeof(IEnumerable<EmployeeModel>))]

生成的JSON doc生成：

"responses": {
          "200": {
            "description": "IEnumerable<EmployeeModel>",
            "schema": {
              "type": "array",
              "items": {
                "$ref": "#/definitions/ResourceModels.EmployeeModel"
              }
            }
          },
          "400": {
            "description": "BadRequest"
          }
        }

然而，Swagger UI仅显示IEnumerable并删除<EmployeeModel>。我确信插入符号是罪魁祸首。有解决方法吗？

Answer 1

据Swagger说：

这实际上是描述中的错误。那个字段是gfm，意思是＆lt;＆gt;中的任何内容将被视为html，因此如果您希望显示这些字符，则需要将其转义。