openapi3/swagger描述文本中的内联图像

openapi3/swagger描述文本中的内联图像,swagger,swagger-ui,openapi,Swagger,Swagger Ui,Openapi,是否可以在openapi3.0/swagger中将内联图像作为描述文本等的一部分进行渲染? 在查看规范时,我所能找到的就是能够链接到请求示例中的图像,特别是。我希望能够在API的介绍性文本中包含图表等,类似于markdown等。示例: openapi: 3.0.2 info: version: "1.0.0" title: "My API" description: "This API bla bla bla [block diagram] bla bla [another inli

是否可以在openapi3.0/swagger中将内联图像作为描述文本等的一部分进行渲染? 在查看规范时,我所能找到的就是能够链接到请求示例中的图像,特别是。我希望能够在API的介绍性文本中包含图表等,类似于markdown等。示例:

openapi: 3.0.2
info:
  version: "1.0.0"
  title: "My API"
  description: "This API bla bla bla [block diagram] bla bla [another inline image]"

这样做可能吗?

至少在ReDoc渲染器中,似乎可以直接在描述文本中使用HTML,因此添加
似乎是可行的:

openapi: 3.0.2
info:
  version: "1.0.0"
  title: "My API"
  description: "This API bla bla bla <img src="./block-diagram.png" /> bla bla <img src="./another-inline-image.png" />
openapi:3.0.2
信息:
版本:“1.0.0”
标题:“我的API”
描述:“此API bla bla bla bla bla
我不知道是否有更好的方法,也不知道这种方法是否有局限性,例如跨来源问题。

相关(或重复):