Some earlier comments on newlines in KDoc comments...
# announcements
d
Some earlier comments on newlines in KDoc comments were wrong: common-markdown does not enforce linebreaks. This is outlined in the spec in section 4.8: (http://spec.commonmark.org/0.27/#paragraphs)
A sequence of non-blank lines that cannot be interpreted as other kinds of blocks forms a paragraph. The contents of the paragraph are the result of parsing the paragraph’s raw content as inlines. The paragraph’s raw content is formed by concatenating the lines and removing initial and final whitespace.
your options for hard line breaks are outlined in section 6.9 (http://spec.commonmark.org/0.27/#hard-line-break) - The most appropriate for KDoc seems to be to use a trailing \ I should probably add this info to KT-15118 - but that'd require me getting an account and jumping through some hoops