Markdown 基础语法

Mr.R0boter 于 2020-08-13 发布

标题的写法

  1. 使用#后面带文字的方法,分别表示 h1 到 h6,h1 级的标题会自带分割线,

    Tipe:Markdown 只有 h1-h6 的标题效果,更多的等同 h6

  2. 标题 空行 ==,相当于 H1 的效果

    Tipe:第三行所用的=需两个及两个以上

  3. 标题 空行 –,相当于 H2 的效果

    Tipe:第三行所用的-需两个及两个以上

段落的分割

  1. 普通分割,使用空行进行分割,连着多少空行的效果都只显示为一行

    Tipe:有些语法必须使用空行才能有效果如(主标题和列表),不空行默认跟随上文的语法(如表格语法)

  2. 水平分割,用三个*或-或_来进行表示(建议使用固定的方法如三个*,使用符号应单独占一行)

区块(可嵌套)

使用>可以建立区块引用

> 这是区块内的内容
> 内容

Tipe:同一区块内允许只在开头使用>,这种写法允许换行,但不允许空行。区块内同样支持 markdown 的语法

列表(可嵌套)

  1. 无序列表,使用*,+或-作为列表标记

     * 第一条
     * 第二条
     * 第三条
    
  2. 有序列表,使用数字加英文点号

     1. 第一条
     2. 第二条
     3. 第三条
     如果要在列表内放入引用区块,那么在>前就需要缩进(一次),如果要放入代码区块就需要直接缩进两次
    

代码区块

  1. 直接缩进,仅限于处在一个普通段落后面,且中间隔开一个空行,这个代码区块会一直持续到没有缩进的那一行或文件结尾。如果在列表中使用需缩进两次

  2. 使用三个反引号

    代码
    代码
    代码
    

Tipe:处于代码区块中的内容将进行代码高亮,而且如果你输入的是 markdown 代码,他将显示你输入的原始内容

强调

Markdown 使用星号和下划线作为标记强调字词的符号。

  1. 单个的星号和下划线表示斜体。
  2. 双星号和双下划线表示粗体
  3. 三个星号和下划线表示粗斜体

使用双波浪线表示删除线

示例:

*斜体*
_斜体_
**粗体**
__粗体__
***粗斜体***
___粗斜体___
~~删除线~~

强制换行

使用两个空格加回车可以强制换行,或者使用 HTML 中的<br/>标签

行内代码

使用反引号`可以在行内标注出一小段代码(代码是一句连贯的没有换行的)

如果代码中包含反引号,则使用两个反引号来开启和结束代码

链接

  1. 链接的自动展示,你可以直接输入一段链接,它可以直接识别,或者在链接的两头使用尖括号将链接括起来 Tipe:邮箱地址需使用尖括号括起来<邮箱地址>

  2. 一般链接方式,分为网页链接和图片链接

    • 网页链接[链接文字](http://链接地址(空格)"鼠标悬停显示文字(可选)")

    • 图片链接![图片描述](图片网络/本地图片地址(空格)"鼠标悬停显示文字(可选)")

  3. 参考式链接,分为定义和引用

    • 定义:网页链接和图片链接的定义方式是一样的 [id](地址 " 鼠标悬停时显示的描述(可选)")

      Tipe:定义可以放在任何地方,一般放在文章底部

    • 引用:图片的引用需要在 id 前加感叹号,网页链接不需要

      网页链接:[id]

      图片链接:![id]

转义

Markdown 中如果要使用下面的符号作为普通符号使用需要在符号前加反斜杠 \ 反斜线

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

表格

语法:

| 1 | 2 |
| - | - |
| 1 | 2 |
| 1 | 2 |

效果:

1 2
1 2

Tips:写表格时需与上一行隔一个空行