我想格式化我的Swagger API描述,以便它们不是简单的文本段落.最好,我想为它添加一个小桌子.
我没有在Swagger描述中找到有关文本格式的在线参考.如果我启动Swagger编辑器,并打开Instagram示例(File\Open Example\Instagram.yaml),我看到yaml文件中的第一个描述显示了一些格式,包括超链接和边界框:
[registered your client](http://instagram.com/developer/register/) it's easy
to start requesting data from Instagram.
```
https://api.instagram.com/v1/media/popular?client_id=CLIENT-ID
```
Run Code Online (Sandbox Code Playgroud)
这看起来像标准的Markdown,但是当我在样本描述中添加表markdown时,编辑器会出现错误:
|Col1|Col2|
|------|------|
|1|2|
YAML Syntax Error
End of the stream or a document separator is expected at line 36, column
Run Code Online (Sandbox Code Playgroud)
Swagger 2.0允许什么格式化?我做错了呈现一张桌子吗?
如何在 swagger 编辑器中指定 3 列,以便输出应如下所示:
ABC XYZ
a b c x y z