Swagger 2.0 텍스트 설명을 포맷하는 방법은 무엇입니까?

Question

Swagger API 설명을 간단한 단락이 아니도록 서식을 지정하고 싶습니다. 가급적이면 작은 테이블을 추가하고 싶습니다.

Swagger 설명에서 텍스트 서식에 대한 온라인 참조를 찾지 못했습니다.

[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 
``` 

이를 : 나는 Swagger Editor를 시작하고, 인스 타 그램의 예 (파일 \ 열기 예 \ Instagram.yaml)를 열면, 나는 YAML 파일의 첫 번째 설명이 하이퍼 링크 및 경계 상자를 포함한 일부 서식을 보여줍니다 참조 표준 Markdown처럼 보이지만 내가 샘플 설명에 테이블 인하를 추가 할 때, 에디터는 오류 제공 :

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


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

자신감 2.0은 어떤 형식을 허용 않습니다를? 테이블을 렌더링하는 데 문제가 있습니까?

Answer 1

마크 다운은 swagger-editor에지지되고 후속하는 자신감 문서 마크 다운을 사용하는 예이다

가

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). 

    Tables: 

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

복사 출력을 볼 swagger-editor 위 예를 붙일 수는.