Yaml swagger编辑器中的多行文字？

我试图在Swagger编辑器中获得一个多行文字（顺便说一下，这是一个很棒的工具！）

我用|和>，用不同的结尾（增加缩进与空行），以及我能想到的各种方法尝试过，但它总是给出相同的错误：

YAML Syntax Error
Can not read a block mapping entry; a multiline key may not be an implicit  
key at line 24, column 15: consumes: ^

---

我看到JS-YAML的bug，表明问题出在最后是一个Windows风格的换行符，我知道HTML文本区域可以创建这个换行符。这是我第一次真正大量使用YAML，那么是我做错了什么，还是Swigger editor中出现了一个bug？

我相信问题在于您在描述块上开始文本的方式。它必须在描述的右边缩进一级：下面是一个适合我的例子：

/{user-id}:
get:
  summary: Facebook User
  description: |
    Displays all information about a Facebook user, depending on access privileges.  Displays all information about a Facebook user, depending on access privileges.
  parameters:
    - name: user-id
      in: path
      description: The Facebook user ID
      required: true
      type: string

---

在我的实际代码中，描述有三行长。

想要添加JSON方法。我在Swagger编辑器中使用纯JSON来避免双重语法问题（学习、调试、解析等）

---

出于某种原因，似乎需要使用双换行符

\n

，至少要在Swagger编辑器上呈现新行。然而，当我将官方Uber API YAML导出为JSON（文件->下载为JSON）时，生成的JSON只有一个换行符，其中显示了多行文字。奇怪。

是缩进。应该是这样的：

  post:
    summary: Translate one or more identifiers
    description: |
      Translate one or more identifiers for one entity into the
      identifiers of another entity. Translate one or more
      identifiers for one entity into the identifiers of another entity.

---

就我而言，这只是一个/，我应该把它放在永久链接的开头，在我的类别中。md：

permalink: /{{ blog.catPermalinkPrefix }}/{{ category.slug }}/ 

---

好节目。。。谢谢这个细节在YAML规范中一点也不清楚。在我的例子中，同样的错误消息是由于在前一行（摘要）的冒号后缺少空格造成的，但是你的回答让我看得更仔细。我发现在在线招摇编辑器中调试这样的语法错误很困难。这些问题在像SublimiteText这样的文本编辑器中更容易识别，在那里颜色编码被用来突出语法问题。我想这样的事情远比我问这个问题时发展得更为成熟。今天我可能会使用VSC。

  post:
    summary: Translate one or more identifiers
    description: |
      Translate one or more identifiers for one entity into the
      identifiers of another entity. Translate one or more
      identifiers for one entity into the identifiers of another entity.

permalink: /{{ blog.catPermalinkPrefix }}/{{ category.slug }}/