美文网首页
Markdown 语法的使用

Markdown 语法的使用

作者: SyKay | 来源:发表于2020-05-19 15:59 被阅读0次

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

    一、标题

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

    二、字体

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

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


    三、引用

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

    效果如下:

    这是一级引用的内容

    这是二级引用的内容

    这是三级引用的内容


    四、分割线

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

    效果如下:







    五、图片

    语法如下:
        ![这里是图片的注释](这里是图片的地址)
    
    例:
        ![图片标题](https://img.haomeiwen.com/i23466769/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语法大全(超级版)

    相关文章

      网友评论

          本文标题:Markdown 语法的使用

          本文链接:https://www.haomeiwen.com/subject/ecogohtx.html