markdown学习

Markdown 致力于使阅读和创作文档变得容易

基础语法

标题

Markdown支持6种级别的标题，对应html标签 h1 ~ h6

    # h1
    ## h2
    ### h3
    #### h4
    ##### h5
    ###### h6

以上标记效果如下：

h1

h2

h3

h4

h5

h6

段落与区块引用

Markdown提供了一个特殊符号>用于段首进行强调，被强调的文字部分将会高亮显示

    > 这段文字将被高亮显示...

以上标记显示效果如下：

这段文字将被高亮显示…

插入链接或图片

Markdown针对链接和图片的处理也比较简单，可以使用下面的语法进行标记

    [点击跳转至百度](http://www.baidu.com)
    ![图片](https://upload-images.jianshu.io/upload_images/703764-605e3cc2ecb664f6.jpg?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)

以上标记显示效果如下：
点击跳转至百度

注： 引用图片和链接的唯一区别就是在最前方添加一个感叹号。

列表

Markdown支持有序列表和无序列表两种形式：

• 无序列表使用*或+或-标识
• 有序列表使用数字加.标识，例如：1.

比如：

    * 黄瓜
    * 玉米
    * 茄子

    + 黄瓜
    + 玉米
    + 茄子

    - 黄瓜
    - 玉米
    - 茄子

    1. 黄瓜
    2. 玉米
    3. 茄子

以上标记显示效果如下：

• 黄瓜
• 玉米
• 茄子

• 黄瓜
• 玉米
• 茄子

• 黄瓜
• 玉米
• 茄子

1. 黄瓜
2. 玉米
3. 茄子

注：这里比较有趣的地方是，对于有序列表，Markdown将只关注你的第一个项目的数字编号。例如：如果第一个项目编号是3，以此类推，第二个项目应该是4，最终将显示为3、4、5。而如果你指定了第一个编号，后面的编号指定错误也没有关系，Markdown将只在乎你的第一个项目编号。

如果在单一列表项中包含了多个段落，为了保证渲染正常，*与段落首字母之间必须保留四个空格

    *    段落一
         小段一
    *    段落二
         小段二

以上标记显示效果如下：

• 段落一
  小段一
• 段落二
  小段二

另外，如果在列表中加入了区块引用，区域引用标记符也需要缩进4个空格

    * 段落一
      > 区块标记一
    * 段落二
      > 区块标记二

以上标记显示效果如下：

• 段落一

  区块标记一

• 段落二

  区块标记二

注：记住一个原则，如果在和列表配合使用的时候出现了问题，就缩进一次，四个空格或者一个制表符代表一次缩进。如果一次缩进没有解决问题，那就两次。

分隔线

Markdown加入分隔线非常简单，使用下面任意一种形式都可以

    ***
    ---

以上标记显示效果如下：

---

---

强调

有时候，我们希望对某一部分文字进行强调，使用*或_包裹即可。使用单一符号标记的效果是斜体，使用两个符号标记的效果是加粗

    *这里是斜体*
    _这里是斜体_

    **这里是加粗**
    __这里是加粗__

以上标记显示效果如下：

这里是斜体
这里是斜体

这里是加粗
这里是加粗

##代码块

使用反引号`进行包裹即可。如果是行内代码引用，使用单个反引号进行包裹

这是一段x+y=5行内代码

如果插入一整段代码，需要至少使用两个以上反引号进行包裹，

    ```
    fun (x: Int, y: Int): Int {
    return x + y
    }
    ```

以上标记显示效果如下：

fun (x: Int, y: Int): Int {
return x + y
}

特殊符号处理

Markdown使用反斜杠\插入语法中用到的特殊符号。在Markdown中，主要有以下几种特殊符号需要处理：

    \   反斜线
    `   反引号
    *   星号
    _   底线
    {}  花括号
    []  方括号
    ()  括弧
    #   井字号
    +   加号
    -   减号
    .   英文句点
    !   惊叹号

例如，如果你需要插入反斜杠，就连续输入两个反斜杠即可：\ => \ 。

注：在内容中输入以上特殊符号的时候一定要注意转义，否则将导致内容显示不全，甚至排版混乱。