markdown-语法.md 2.85 KB

本文的目的不是要做一篇详尽的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>