Markdown常用语法学习笔记

一、基础语法

1.标题

    （1）atx形式：

        #    表示一级标题，即HTML语言中的<h1></h1>标签

        ##    表示二级标题，即HTML语言中的<h2></h2>标签

        ……

        ######表示六级标题，即HTML语言中的<h6></h6>标签

    （2）Setext形式：

        =  底线    表示最高阶标题，即HTML语言中的<h1></h1>标签

        -   底线    表示二阶标题，即HTML语言中的<h2></h2>标签

2.段落

    一个段落是由一个以上的连接的行句组成，而一个以上的空行则会划分出不同的段落（空行的定义是显示上看起来像是空行，例如只有空白和tab）。

    注意，一个以上空行的意思是，当前行输入完毕换行后，再次按下回车键换行，这样即为一个以上空行。显示上看起来是两行文字之间留出一行了空白行。

    段落即为HTML语言中的<p></p>

3.区块

    >    表示区块，即首行缩进一个单位长度（通常为四个空格的长度），即HTML语言中的<blockquote></blockquote>

4.列表

    *     无序列表，对应HTML语言中的<ul><li></li><ul>

    +    无序列表，对应HTML语言中的<ul><li></li><ul>

    -     无序列表，对应HTML语言中的<ul><li></li><ul>

    1.    有序列表，数字加英文句点，对应HTML语言中的<ol><li></li></ol>

    注意：

        你在列表标记上使用的数字并不会影响HTML的输出结果。如果你使用懒惰的写法，建议第一个项目最好从1.开始，因为Markdown未来有可能会支持有序列表的start属性。

        如果在插入列表时，在列表的两项之中插入了空行，则该项内容会用<p>标签包裹起来，你也可以在一项中插入多个段落，只要正确的保证了空行，并且最好开头能够空出四个空格或一个tab，或者是添加一个>使它变成区块，这样和列表显示起来比较整齐。

5.链接

    Markdown支持两种形式的链接语法：行内和参考两种形式。

    （1）行内形式：

          格式：This is an [example link](www.example.com)

          解释：在HTML语言中即为，将example link包裹在<a>标签中，并且href地址为www.example.com。

          格式：This is an [example link](www.example.com "With a title")

          解释：基本同上，区别是指定了该a标签的title属性值为With a title。

    （2）参考形式：

          参考形式的链接可以让你为链接定一个名称，之后在其他地方统一定义链接的内容。

          格式：This is an [example link][1], and [the second example link][2].

                    [1]: www.example.com

                    [2]: www.example2.com "title"

          解释基本同上，需要注意的地方是，[1]不一定非要使用数字，可以使用字母、数字和空格或其组合，但是不分大小写。

6.图片

    图片的语法和链接很像，也分为行内形式和参考形式两种。

    （1）行内形式（title是选择性的）：

          

    （2）参考形式：

          ![alt text][id]

          [id]: /path/to/image.jpg "Title"

    上面两种形式都会输出HTML为：<img src="path/to/image.jpg" alt="alt text" title="Title">

7.代码

    Markdown文档中如果输入HTML代码，是会直接生效的。如果想要显示出一一段代码来而不是让它被解析运行，就使用 ` ` （反引号，英文模式下按键盘左上角的波浪号键，注意不能跨行）将代码部分包裹起来，这样就可以显示出原原本本的代码了。

8.分割线

    可以在一行中使用三个以上的星号、减号、底线来建立一个分割线，行内不能有其他东西。也可以在星号或减号中间插入空格。

    如：* * *

    - - -

    ******

    ------

9.强调

    使用星号（*）和底线（_）作为标记强调字符的符号，被一个（*）或（_）包围的内容会以<em>标签的形式显示，即斜体。被两个（*）或（_）包围的内容将会以<strong>标签的形式显示，即加粗。

    注意，如果（*）或（_）的两边有空白，则会显示成普通的星号或底线。如果想要在文字前后直接插入普通的星号或底线，则需要用到转义字符（\）。