Rest 如何设置Swagger 2.0文本描述的格式？

我想格式化我的Swagger API描述，使它们不是简单的文本段落。最好是，我想在上面加一张小桌子

我在网上找不到关于招摇过市描述中文本格式的参考资料。如果启动并打开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
```

这看起来很标准，但当我将表标记添加到示例描述时，编辑器会显示一个错误：

|Col1|Col2|
|------|------|
|1|2|


YAML Syntax Error
End of the stream or a document separator is expected at line 36, column

Swagger 2.0允许什么格式？

---

渲染表时我是否做错了什么？

Swagger编辑器支持标记。下面是在OpenAPI（Swagger）文档中使用标记的示例：

swagger: '2.0'
info:
  version: 0.0.0
  title: Markdown 
  description: |
    # Heading

    Text attributes _italic_, *italic*, __bold__, **bold**, `monospace`.

    Horizontal rule:

    ---

    Bullet list:

      * apples
      * oranges
      * pears

    Numbered list:

      1. apples
      2. oranges
      3. pears

    A [link](http://example.com).

    An image:
    ![Swagger logo](https://raw.githubusercontent.com/swagger-api/swagger-ui/master/dist/favicon-32x32.png)

    Code block:

    ```
    {
      "message": "Hello, world!"
    }
    ```

    Tables:

    | Column1 | Column2 |
    | ------- | --------|
    | cell1   | cell2   |
paths:
  /:
    get:
      responses:
        200:
          description: OK

---

您可以将上述示例复制并粘贴到以查看输出。

Ah。我知道为什么。YAML对压痕很敏感。我做得不对。Thanx Wilson@Wilson，这种降价支持是否仅限于信息部分？当我将其复制/粘贴为宠物对象的描述时，其显示与插入“信息”部分时不同。谢谢@Stephen McFarland-说明的第一行应该是“|”，说明中需要的文本应该缩进。@Stephen McFarland-说明的第一行应该是“|”，说明中需要的文本应该缩进。很抱歉，我无法发表评论，因为我还没有50个代表。作为答复张贴在。我想在他们的“答案”被删除之前，我会很好地传递消息。所以你不能在UI中实际跟踪呈现的链接。美好的