前言在《一篇带你用 VuePress + Github Pages 搭建博客》我们使用VuePress搭建了一个博客,最终效果查看:TypeScript中文文档。在优化博客的过程中,因为需要写markdown-it插件,查看了markdown的CommonMarkSpec,突然发现自己对Markdown的了解还不够:软换行符(Softlinebreaks)换行符不在内联代码或HTML标记中。如果没有两个或更多的空格,它将被解析为软换行符。呈现为HTML时的行终止符或空格。输入:foobaz输出:
foobaz
性能:硬换行符(Hardlinebreaks)换行符不是内联代码或HTML标签,前面有两个或多个空格,并且不在块的末尾,将解析为硬换行符并呈现为HTML中的标记。输入(注意foo后面有两个空格):foobaz输出:
foobaz
性能:反斜杠(backslash)除转义外相当于行尾的硬换行符:input:foo\barOutput:foobar
Inlinecode(codespan)我们通常用一对反引号将字符串包裹起来,表示inlinecode(codespan):Input:`foo`Output:foo
foo
foo
性能:作为内联代码,而不是需要三个反引号,因为只要前后至少有3个且相同,那么当我们想在一个代码块中使用3个反引号时,可以使用4个反引号:``````markdownfoo```````性能是:不要使用反引号,使用波浪号也是可以的,但是不能混用:~~~foo~~~output:foo
indentationIndentedcodeblocks(缩进代码块)缩进代码块由若干个用空行分隔的缩进块组成。缩进块是一些非空行,每行缩进四个或更多空格。缩进块示例:一个简单的缩进代码块输出:一个简单的缩进代码块
性能:由空行分隔的多个缩进块示例:chunk1chunk2chunk3输出:chunk1chunk2chunk3
三个缩进块一起组成一个缩进代码块。性能:链接引用定义(Linkreferencedefinitions)链接引用定义由一个链接标签、一个冒号(:)、可选的空格、一个链接目标、可选的空格和一个可选的链接标题组成。例如:[foo]:/url"title"但这只是一个定义,不会显示,就像我们在JavaScript中声明一个变量,如果我们要使用它:[foo]输出:Foobar
Foobar
使用=是一级标题,使用-字符是二级标题。底线的长度是任意的。水平线(Thematicbreaks)缩进0-3个空格,由三个或更多-、_、*字符组成的线组成一条水平线。输入:***---____输出:性能:系列文章博客搭建系列是我目前为止唯一写的实用系列教程,期待约20篇文章,讲解如何使用VuePress搭建和优化博客,并部署到GitHub、Gitee、私服等平台。本文为第19篇,全系列文章地址:https://github.com/mqyqingfen...微信:“mqyqingfeng”,加我到SaeYu的唯一读者群。如有错误或不准确的地方,请务必指正,万分感谢。如果你喜欢或者有启发,欢迎star,这也是对作者的鼓励。