本文的目的不是要做一篇详尽的markdown使用教程,仅仅是对markdown知识点的梳理,系统的教程请戳这里。
学习markdown最好的方式就是在编辑器中随意的敲几行,和自己的预期对比。这里推荐一款实时预览的markdown编辑器markdownpad。
markdown和html的区别?
Markdown是一种书写的格式,HTML是一种发布的格式。
标题
在行首插入 1 到 6 个#,对应到标题 1 到 6 阶
区块引用
在行首或者段落首插入>
> This is a blockquote with two paragraphs.
> Lorem ipsum dolor sit amet.
和
> This is a blockquote with two paragraphs.
Lorem ipsum dolor sit amet.
效果是一样的。
列表
无序列表在行首插入一个*
或+
或-
都可以。
有序列表在行首插入一个数字紧跟一个英文句点(数字不会在输出结果中显示,无序列表会被转义成了<ol>
)
列表项目可以包含多个段落,每个项目下的段落都必须缩进 4 个空格或是 1 个制表符(否则会被转义成一个段落)
列表项目内放进引用>
需要缩进(否则会被当成一个新行的引用)
code区块
要在 Markdown 中建立代码区块很简单,只要简单地缩进 4 个空格或是 1 个制表符。(区块的前面还必须至少包含一个空行)
分隔线
在一行中用三个以上的星号、减号、底线来建立一个分隔线,行内不能有其他东西。
使用减号-
作为分隔线时需要与上面的段落之间至少包含一个空行(否则段落的字体会被作为标题显示,不知道是不是编辑器的原因)
链接
建立一个行内式的链接,只要在方块括号后面紧接着圆括号并插入网址链接即可,如果你还想要加上链接的 title 文字,只要在网址后面,用双引号把 title 文字包起来即可,例如:
[LrEmo's notes](https://metrohub.github.io "LrEmo's notes")
请注意:有一个已知的问题是 Markdown.pl 1.0.1 会忽略单引号包起来的链接 title。
强调
Markdown 使用星号*
和底线_
作为标记强调字词的符号,被*
或_
包围的字词会被转成用 <em>
标签包围,用两个*
或_
包起来的话,则会被转成<strong>
。
但是如果你的*
和_
两边都有空白的话,它们就只会被当成普通的符号。
图片
图片的语法和链接很像,只是在前面多了一个!
自动链接
Markdown 支持以比较简短的自动链接形式来处理网址和电子邮件信箱,只要是用尖括号包起来, Markdown 就会自动把它转成链接。一般网址的链接文字就和链接地址一样,例如:
<https://metrohub.github.io>
<in.sea@Foxmail.com>