swagger - 在描述中使用 $ref

Question

我想$ref在我的 openapi.yaml 文件的描述部分使用。当我在浏览器中查看它时它可以工作，但我想摆脱“语法错误”。

openapi: 3.0.3
info:
  title: A nice title
  version: 1.0.0
  description:
    $ref: './description.md'
...

产生以下错误：

未知的内容类型

这样做的正确方法是什么？根据Swagger 的文档，这是一个有效的标签

标签： swaggeropenapi