New lines in description create incorrect markdown

[alexec]

Problem statement

Converting a swagger.yaml file to swagger.md create incorrect markdown, because the new lines are not remove/escaped (or what ever is needed).

argoproj/argo-workflows#7615

Swagger specification

Steps to reproduce

Environment

swagger version: v0.29.0
go version: 1.17
OS: MacOS

[fredbi]

Rewriting new lines with
seems to be a popular markdown tip:

Filesystem type of the volume that you want to mount.

Tip: Ensure that the filesystem type is supported by the host operating system.
Examples: "ext4", "xfs", "ntfs". Implicitly inferred to be "ext4" if unspecified.
More info: https://kubernetes.io/docs/concepts/storage/volumes#awselasticblockstore

Using block quote alters the rendering, so this is probably not what we want.

Filesystem type of the volume that you want to mount.
Tip: Ensure that the filesystem type is supported by the host operating system.
Examples: "ext4", "xfs", "ntfs". Implicitly inferred to be "ext4" if unspecified.
More info: https://kubernetes.io/docs/concepts/storage/volumes#awselasticblockstore

[fredbi]

Provided example would render like so:

Properties

Name	Type	Go type	Required	Default	Description	Example
fsType	interface{}	interface{}			Filesystem type of the volume that you want to mount. Tip: Ensure that the filesystem type is supported by the host operating system. Examples: "ext4", "xfs", "ntfs". Implicitly inferred to be "ext4" if unspecified. More info: https://kubernetes.io/docs/concepts/storage/volumes#awselasticblockstore TODO: how do we prevent errors in the filesystem from compromising the machine