2017-02-20 78 views
1

如何在使用JSON编写Swagger中的描述时创建新段落?使用JSON时Swagger描述中的新段落

我只找到YAML的例子,当我像Markdown一样简单创建一个新段落时,验证失败,文档不再呈现。

我想

什么第一段描述了电话。

另一段提供了有关该呼叫的其他信息。

我试过,但不起作用

"description": "The first paragraph describes the call. 

Another paragraph gives additional information about the call.", 

回答

2

JSON不支持文字多行字符串。

更换符合\n突破应该工作,例如:

"description": "The first paragraph describes the call.\n\nAnother paragraph gives additional information about the call.", 
+0

只尝试一个'\ N'它不具有任何影响,放弃了。 – mrplow

+1

@mrplow,这会给你一个换行符,但由于描述字段使用GitHub格式化Flavored Markdown段落必须用空行分隔,因此第二个'\ n'。 – Chris