• Markdown语法介绍


    前言

    最近准备开始写博客,整理自己学习的技术知识。但手动调整博客的文本格式实在太不美观和geek,因而选择Markdown排版博客内容。Markdown是一种轻量级标记语言,且兼容HTML。可通过标记符号设置文本格式,让作者专注于写作内容,当前的主流博客网站和GitHub版块多采用Markdown。

    Markdown将格式对象主要分为区块元素区段元素两部分。区块元素主要包括段落换行标题区块引用列表分割线;区段元素包括强调链接图片代码块

    区块元素

    段落和换行

    Markdown中段落是由一个或多个连续的本文组成,段落前后应该有1个以上的空行,单独的换行符不会实现段落换行。如果不想插入空行进行换行,可以在换行符前插入2个以上的空格来实现段落换行。例如:

    第一段

    第二段

    第一段(两空格)
    第二段

    标题

    在标题文本前使用“#”,并用空格分割可以创建一级标题。如果需要创建多级标题,可使用不同数量的“#”,最多可创建6级标题。如下所示:

    # 一级标题
    ## 二级标题
    ### 三级标题
    #### 四级标题
    ##### 五级标题
    ###### 六级标题

    区块引用

    Markdown标记区块引用时,在每行的开头添加符号">"或在每段的第一行开头添加">",如下所示:

    > This is a blockquote with two paragraphs. Lorem ipsum dolor sit amet, consectetuer adipiscing elit.
    Aliquam hendrerit mi posuere lectus. Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, risus.

    > This is a blockquote with two paragraphs. Lorem ipsum dolor sit amet, consectetuer adipiscing elit.
    >Aliquam hendrerit mi posuere lectus. Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, risus.

    效果如下:

    This is a blockquote with two paragraphs. Lorem ipsum dolor sit amet, consectetuer adipiscing elit.
    Aliquam hendrerit mi posuere lectus. Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, risus.

    另外区块引用允许多级嵌套,只需根据层次添加不同数量的">"。例如:

    > 这是第一级引用。
    >
    > > 这是第二级引用。
    >
    > 现在回到第一级引用。

    效果如下

    这是第一级引用。

    这是第二级引用。

    现在回到第一级引用。

    列表

    Markdown支持有序列表和无序列表。

    无序列表使用“*”,"+"和"-"作为记号,通常放在最左侧,记号与文本间用空格分割。

    * 列表1
    * 列表2
    * 列表3

    效果如下

    • 列表1
    • 列表2
    • 列表3

    有序列表使用数字加英文句号作为记号,记号与文本间用空格分割,且有序列表的序号与记号中的数字无关。例如以下两组列表,生成的列表序号相同。

    1. 列表1
    2. 列表2
    3. 列表3

    1. 列表1
    1. 列表2
    1. 列表3

    效果如下

    1. 列表1
    2. 列表2
    3. 列表3

    如果需要在列表中加入区块引用或代码块,则整个区块或代码块需整体缩进4个空格或一个制表符,例如:

    * 列表1
            > 引用内容

    效果如下所示

    • 列表1

      引用内容

    分割线

    在单独的一行中使用三个以上的星号"*",减号“-”或底线"_"来创建分割线,且行内不能再有其他内容。

    ___
    ***
    ---

    效果如下


    区段元素

    强调

    强调包括斜体加粗两种方式。

    斜体使用一对“*”包裹需要强调的文字,例如:

    *斜体*

    其效果为:斜体

    加粗使用一对“**”包裹需要强调的文字,例如:

    **加粗**

    其效果为:加粗

    代码块

    标记代码块的方式有两种。一种是通过缩进4个空格或1个制表符进行标记;更常用的方法是使用反引号将代码块包裹起来,避免无休止的缩进。该方法可指定语言标识,对标记的代码块启用语法着色。例如:

    ```python
    import sys
    img_list_in = open(sys.argv[1])
    ```

    效果如下:

    import sys
    img_list_in = open(sys.argv[1])
    

    链接

    Markdown支持两种链接的表示方式:内联式引用式

    内联式的表示形式为 [text] (URL)。其中,[]中的内容是链接文字,()中的内容是链接地址。例如:

    This is [GitHub] (https://www.github.com) link.

    效果如下
    This is GitHub link.

    引用式的表示方式为

    [text] [id]

    [id]: URL

    例如:

    This is [GitHub] [github] link.

    [github]: https://www.github.com

    效果如下:
    This is GitHub github link.

    插入图片

    Markdown使用与链接相似的语法来插入图片,也可分为内联式和引用式。

    内联式插入图片的语法为:

    ![text] (URL)

    引用式插入图片的语法为:

    ![text] [id]

    [id]: URL

    例如:

    ![CR7](http://bestsportsshots.com/wp-content/uploads/2018/01/cr7-power.jpg)

    ![CR7] [player]

    [player]: http://bestsportsshots.com/wp-content/uploads/2018/01/cr7-power.jpg

    效果如下
    CR7

    需要注意的是,Markdown无法指定插入图片的宽高。如果需要,可以使用 <img>标签。

  • 相关阅读:
    nginx安装
    win7 mount到Linux下无法分配内存的问题(Cannot allocate memory)
    [转]linux时间同步
    关于文件缓冲的问题
    【转】VNC配置
    yum代理设置
    mysql开启日志
    [译]rabbitmq 2.5 Where’s my message? Durability and you
    [译]rabbitmq 2.4 Multiple tenants: virtual hosts and separation
    [译]rabbitmq 2.2 Building from the bottom: queues
  • 原文地址:https://www.cnblogs.com/chimoxuanzhi/p/8977834.html
Copyright © 2020-2023  润新知