在markdown代码中打破长行

时间:2013-11-14 18:16:12

标签: markdown

我正在使用here描述的原始降价标记。

我想知道是否有可能在降价代码中打破长行而导致没有语法效果。 (在其他语言中,例如shell脚本和C,\将用于继续到下一行。)我问这是因为换行符有时会破坏语法,如

[StackOverflow]
(http://stackoverflow.com)

这将在实际的html中以“[StackOverflow](http://stackoverflow.com)”而不是超链接结束,因为换行符被解释为空格,并且]和{{之间不允许有空格1}}在链接的(语法中。

2 个答案:

答案 0 :(得分:16)

如果你想在代码中有换行符,那么,正如评论所说,在文本部分或url部分内部使用换行符:你实际上可以这样做

[StackOverflow](
http://stackoverflow.com)

虽然结果会在href内部有额外的空格,但它仍然有用,所以不用担心。这也适用于在多行上传播长链接

[StackOverflow interesting discussion](
    http://stackoverflow.com/this/discussion/has/a/very/
very/very/very/long/long/long/title/title/title

请确保不要在URL(此处为最后一行)的行上放置任何前导空格。 (只有第一个换行符与GitHub-flavored markdown一起使用,因为GitHub将换行符视为空格)。

但是,如果目标是使链接更具可读性,我建议使用链接引用,这样您就可以将实际的href放在文档的任何位置,并在文本中包含简短易读的链接标题:

[StackOverflow][]

[StackOverflow]: http://stackoverflow.com

[StackOverflow][1]

[1]: http://stackoverflow.com

请注意,您可以将引用放在任何位置:当所有引用位于自述文件的底部时,它通常具有可读性且易于维护。

此外,如果您需要,可以使用此metgod将title属性添加到链接:

[StackOverflow][]

[StackOverflow]: http://stackoverflow.com (Here is this link's title!)

答案 1 :(得分:6)

添加到@kizu's answer上的另一种类型的链接是"shortcut reference link",它的字符数更少,而且我认为看起来更好。

它们看起来像这样:

Here's a link to [Stack Overflow]. You should be able to find an
answer there. If not, let me know.

[Stack Overflow]: https://stackoverflow.com

For additional information, check out [this answer].

[this answer]:
https://stackoverflow.com/a/59956334/384954

呈现如下

这里是Stack Overflow的链接。您应该可以找到一个 在那里回答。如果没有,让我知道。

有关其他信息,请查看this answer