CommonMark在段落中间插入列表

Question

我希望看到以下文本（在80个字符标记处注意换行符）：

This worked for a few months. Unfortunately, occasionally a test would time
out and fail after 18 seconds - maybe 1 in 100 test runs would fail with a
timeout. Normally when the tests fail you get back some kind of error message
- a Postgres constraint failure will print a useful message, or a Javascript
exception will bubble up, or Javascript will complain about an unhandled
rejection.

通过markdown编辑器运行时，生成以下HTML：

<p>
This worked for a few months. Unfortunately, occasionally a test would time
out and fail after 18 seconds - maybe 1 in 100 test runs would fail with a
timeout. Normally when the tests fail you get back some kind of error message
- a Postgres constraint failure will print a useful message, or a Javascript
exception will bubble up, or Javascript will complain about an unhandled
rejection.
</p>

通过cmark运行它时，得到以下信息：

<p>This worked for a few months. Unfortunately, occasionally a test would time
out and fail after 18 seconds - maybe 1 in 100 test runs would fail with a
timeout. Normally when the tests fail you get back some kind of error message</p>
<ul>
<li>a Postgres constraint failure will print a useful message, or a Javascript
exception will bubble up, or Javascript will complain about an unhandled
rejection.</li>
</ul>
<p>With this error we didn't get any of those. We also observed it could happen
anywhere - it didn't seem to correlate with any individual test or test file.</p>

这似乎不正确-我绝对不希望列表在段落的中间开始。 这是规范中的问题，还是我可以采取其他措施以不触发此行为？

Answer 1

简而言之，请使用适当的字符（可能是破折号），而不要使用连字符。

规格说明 ：

在CommonMark中，列表可以中断段落。 也就是说，无需空行即可将段落与以下列表分开：

 Foo - bar - baz <p>Foo</p> <ul> <li>bar</li> <li>baz</li> </ul> 

稍后将解释这是因为CommonMark坚持统一性原则 。 具体来说，以列表标记开头的行始终是列表项，而不管周围有任何行。 规范甚至承认Markdown在这里的行为有所不同，特别是为了避免您遇到的问题，但是CommonMark宁愿统一而不是合理/易于使用（显然）。

因此解决方案是，当该行不是列表项时，永远不要以该列表标记开始。 尽管您可以仔细地换行，但以后的编辑可能会重新引入问题。 幸运的是，连字符（Unicode char \‐ ，它是键盘上的字符，并且用作列表标记的字符）很少像列表标记那样用在正确的英语语法中。 特别是，连字符绝不能跟空格，这是列表标记所必需的。 如果要用空格跟随字符，则可能需要使用endash（Unicode char \– ），emdash（Unicode char \— ）或减号（Unicode char \− ）（有关说明，请参见此问题 ）。 因此，使用适当的字符可以避免问题。

让我们尝试一下：

This worked for a few months. Unfortunately, occasionally a test would time
out and fail after 18 seconds — maybe 1 in 100 test runs would fail with a
timeout. Normally when the tests fail you get back some kind of error message
—  a Postgres constraint failure will print a useful message, or a Javascript
exception will bubble up, or Javascript will complain about an unhandled
rejection.

然后，CommonMark的输出为：

<p>This worked for a few months. Unfortunately, occasionally a test would time
out and fail after 18 seconds — maybe 1 in 100 test runs would fail with a
timeout. Normally when the tests fail you get back some kind of error message
— a Postgres constraint failure will print a useful message, or a Javascript
exception will bubble up, or Javascript will complain about an unhandled
rejection.</p>

注意，对于第一次出现，我使用了HTML实体（ — ），而对于第二次出现，我直接使用了emdash字符（ — ）。 CommonMark将HTML实体转换为Emdash字符，并将原义字符通过原样传递。 为了可读性，实际字符当然更好，尽管由于大多数键盘上都没有出现而很难键入。

如果使用SmartyPant ，则可以使用双（ -- ）或三（ --- ）连字符，SmartyPant可以将连字符分别转换为末尾和短划线。 只要连字符之间没有空格，则双连字符和三连字符不会触发列表。

Answer 2

有什么我可以做些别的来不触发此行为的吗？

以下应避免列出：

This worked for a few months. Unfortunately, occasionally a test would time
out and fail after 18 seconds - maybe 1 in 100 test runs would fail with a
timeout. Normally when the tests fail you get back some kind of error 
message - a Postgres constraint failure will print a useful message, or a 
Javascript exception will bubble up, or Javascript will complain about an
unhandled rejection.