Markdown 语法的使用

日常写博客需要用到的Markdown命令

Posted by Kay on May 20, 2020

Markdown是一种纯文本格式的标记语言。通过简单的标记语法,它可以使普通文本内容具有一定的格式。 相比于富文本编辑器那复杂的代码量,Markdown的标记语法简单很多,基本上几分钟就可以学会。下面简单介绍下Markdown的标签含义。

一、标题

语法如下:
    # 这是一级标题
    ## 这是二级标题
    ### 这是三级标题(本文章的标题 “一、标题” 使用的3级标题)
    #### 这是四级标题
    ##### 这是五级标题
    ###### 这是六级标题(最多支持6级标题)

二、字体

语法如下:
    **这是加粗的文字**
    *这是倾斜的文字*`
    ***这是斜体加粗的文字***
    ~~这是加删除线的文字~~

效果如下:
这是加粗的文字
这是倾斜的文字
这是斜体加粗的文字
这是加删除线的文字


三、引用

语法如下:
    >这是一级引用的内容
    >>这是二级引用的内容
    >>>这是三级引用的内容

效果如下:

这是一级引用的内容

这是二级引用的内容

这是三级引用的内容


四、分割线

语法如下:
    * * *
    ***
    *****
    - - -
    -----------

解释:
    用三个以上的星号、减号、底线来建立一个分隔线,行内不能有其他东西。也可以在星号或是减号中间插入空格。
    分割线使用时,注意和前面的正文之间要隔空一行。
    不然不仅不会起效,而且还为将前面正文样式改变(似乎变成了标题)

效果如下:







五、图片

语法如下:
    ![这里是图片的注释](这里是图片的地址)

例:
    ![图片标题](https://upload-images.jianshu.io/upload_images/23466769-8e9bce46f378d365.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/300)

注意:
    部分url里面可以设置图片大小,此案例的的图片url最后面的数字300表示图片宽度为300像素。

效果如图: 图片标题


六、超链接

语法如下:
    [中括号内是要加超链接的文本](小括号放链接地址)

例:
[孙思锴的博客](https://sunsikai.github.io/)

效果:孙思锴的博客


七、无序列表

语法:
    - 列表内容
    + 列表内容
    * 列表内容

注意:
    无序列表用 - + * 任何一种都可以,- + * 跟内容之间都要有一个空格

效果:

  • 列表内容(-)
  • 列表内容(+)
  • 列表内容(*)

八、有序列表

语法:
    1. 列表内容
    2. 列表内容
    3. 列表内容

注意:
    列内容前面的数字后面要加一点和空格。

效果: 1. 列表内容 2. 列表内容 3. 列表内容


九、列表嵌套

语法:
    1. 一级有序内容
       - 二级无序内容
       - 二级无序内容
          - 三级列表内容
    2. 二级有序内容
       4. 有序列表内容
       1. 有序列表内容
       2. 有序列表内容

注意:
    次级和上一级之间,在次级内容前面在敲三个或以上的空格即可。
    在所有次级的有序列表内容的编号排序,都由次级列表中第一个列表内容的数字序号决定。
    如,尽管我们在次级有序列表里面定义的序号是4,6,7还是4,1,2,页面效果排序都会从4开始(4,5,6)。

效果:

  1. 一级有序内容
    • 二级无序内容
    • 二级无序内容
      • 三级列表内容
  2. 二级有序内容
    1. 列表内容
    2. 列表内容
    3. 列表内容

十、表格

语法:
    表头|表头|表头
    ---|:--:|---:
    内容|内容|内容
    内容|内容|内容

解释:
    第二行分割表头和内容。- 有一个即可,为了对齐,这里多加了
    文字默认居左
    -两边加:表示文字居中
    -右边加:表示文字居右
注意:表格使用前需要和前面的内容隔开一行,否则会识别失败

效果:

表头 表头 表头
内容 内容 内容
内容 内容 内容

十一、代码

语法:
    单行代码:代码之间分别用一个反引号(`)包起来
    多行代码:代码行上下两行分别使用三个反引号(```)包起来

例:
    (```)
            这是多行代码写法
            这是多行代码写法
    (```)

    (`)这是单行代码写法(`)

解释:
    例子里面为了效果显示,我将反引号用小括号括起来防止错出。

效果: 这是单行代码的显示效果

这是多行代码的显示效果
这是多行代码的显示效果

十一、markdown注释(这一条似乎没什么用)

语法:
    [//]: # (哈哈我是最强注释,不会在浏览器中显示。)
    [^_^]: # (哈哈我是最萌注释,不会在浏览器中显示。)
    [//]: <> (哈哈我是注释,不会在浏览器中显示。)
    [comment]: <> (哈哈我是注释,不会在浏览器中显示。)

十二、代码及代码块

语法:
    单行代码:代码之间分别用一个反引号(`)包起来
    多行代码:代码行上下两行分别使用三个反引号(```)包起来

例:
    (```)
            这是多行代码写法
            这是多行代码写法
    (```)

    (`)这是单行代码写法(`)

解释:
    例子里面为了效果显示,我将反引号用小括号括起来防止错出。

效果: 这是单行代码的显示效果

这是多行代码的显示效果
这是多行代码的显示效果

十三、换行

解释:
    段落换行时,记得要在段落的最后面加上两个空格,再进行回车换行。
    如果上一段落结束后没有多加两个空格,在部分情况下回车换行是不会有效果的。

十四、注意事项

使用Markdown标签时,需要严格遵守语法规定,如部分标签(表格、分隔线)使用前需要先和前面的内容隔空一行。如果没遵循语法使用,可能会出现Markdown标签在部分平台编译不成功的情况。这是由于各家平台使用的解释器可能不一样导致的。 例:分割线标签使用时,如没和前边的内容隔空个一行,该标签在简书平台上可以正常使用,而在部分博客(jekyll)上会识别不出来。 如果大家在使用过程中遇到标签失效的情况,可以先将该标签使用的内容和前面的内容用换行符隔开几行试试。


本文章内容参考来源如下:

高鸿祥:Markdown基本语法 择势勤:Markdown语法大全(超级版)