markdown - 打断 Markdown 代码中的长行

标签 markdown

我正在使用原味 Markdown ,如here所述.

我想知道是否可以在 Markdown 代码中打断长行,同时不会产生语法效果。 (在其他语言中,例如 shell 脚本和 C,\ 将用于继续下一行。)我这样问是因为换行符有时会破坏语法,如

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

这最终会在实际的 html 中成为“[StackOverflow] ( http://stackoverflow.com )”而不是超链接,因为换行符被解释为空格,并且 ] 之间不允许有空格。和([text](url)链接语法。

最佳答案

如果您想在代码中使用换行符,那么,正如注释所示,请在文本部分或 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 风格的 markdown,因为 GitHub 将换行符视为空格)。

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

[StackOverflow][]

[StackOverflow]: http://stackoverflow.com

[StackOverflow][1]

[1]: http://stackoverflow.com

请注意,您可以将引用文献放在任何地方:当所有引用文献都放在自述文件的底部时,通常会更容易阅读且易于维护。

此外,如果需要,此方法还允许您向链接添加 title 属性:

[StackOverflow][]

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

关于markdown - 打断 Markdown 代码中的长行,我们在Stack Overflow上找到一个类似的问题: https://stackoverflow.com/questions/19985235/

相关文章:

python - MkDocs 和 MathJax

markdown - Markdown 表中的列表(与Jekyll一起使用)

github - 访问 Github wiki/Markdown 中登录的用户名

syntax-highlighting - SciTE/Notepad++ 中的 Markdown 语法高亮显示

bash - 如何将 Markdown 文档批量转换为 HTML?

删除四开标题幻灯片上的幻灯片编号和页脚

javascript - kramdown rouge 不应该用 jekyll 生成语法高亮类吗?

在 Rstudio 查看器中查看时,在 Rmarkdown 幻灯片中呈现数学字体大小

macos - 将传统换行符转换为 Markdown 双倍行距换行符

html - 使用 <section> 和 <div> block 的 Markdown 范围?