简介

• Markdown 是一种轻量级标记语言，它以纯文本形式 (易读、易写、易更改) 编写文档，并最终以 HTML 格式发布。
• Markdown 也可以理解为将以 Markdown 语法编写的语言转换成 HTML 内容的工具。

语法

1. 标题

   Markdown 语法中的标题可以有六级

   # 一个 '#' 符号表示一级标题
   ## 两个 '#' 符号表示二级标题
   ### 三个 '#' 符号表示三级标题
   #### 四个 '#' 符号表示四级标题
   ##### 五个 ‘#’ 符号表示五级标题
   ###### 六个 '#' 符号表示六级标题
   

   • 效果：

   一级标题

   二级标题

   三级标题

   四级标题

   五级标题

   六级标题

2. 段落

   • 段落的前后要有空行，所谓的空行是指没有文字内容。若想在段内强制换行的方式是使用两个以上空格加上回车（引用中换行省略回车）。

3. 引用

   Markdown 语法中使用 '>' 符号开启应用

   > 在每个段落的每行行首使用 '>' 为一整段落的引用，
   > > 嵌套使用 '> >' 可以在段落引用中追加引用
   

   • 效果：

   区块引用

   嵌套引用

4. 代码块

   代码区块的建立是在每行加上 4 个空格或者一个制表符（如同写代码一样），如

   普通代码:
   
   public static void main(String[] args){
       System.out.print("Hello, Markdown.");
   }
   
   开启代码段落:
   
   ​```java
   public static void main(String[] args){
       System.out.print("Hello, Markdown.");
   }
   ​```
   

   • 效果：

   public static void main(String[] args){
   System.out.print("Hello, Markdown.");
   }

  public static void main(String[] args){
      System.out.print("Hello, Markdown.");
  }

注意点：普通段落和使用 Markdown 符号的段落需要空行

5. 强调

   Markdown 语法中使用 '**<文字>**' 来加粗文字
   eg: **加粗文字**
   
   Markdown 语法使用 '*<文字>*' 来使文字斜体
   eg: *斜体文字*
   
   Markdown 语法使用 '***<文字>***' 加粗并斜体文字
   eg: ***加粗且斜体文字***
   
   Markdown 语法使用 '~~<文字>~~' 给文字加上删除线
   eg: ~~删除文字~~
   

   • 效果：

   加粗文字

   斜体文字

   加粗且斜体文字

   删除文字

6. 分割线

   分割线最常使用就是三个或以上*，还可以使用-和_。

   ---
   ----
   ***
   *****
   

   • 效果：

   ---

   ---

   ---

   ---

7. 链接

   Markdown 语法使用 [baidu](https://www.baidu.com) 标识一个网页链接

   eg: [简书](https://www.jianshu.com/)
   

   • 效果：

   简书

8. 图片

   Markdown 语法使用 ![图片]()

   ![黄图](https://ss0.bdstatic.com/94oJfD_bAAcT8t7mm9GUKT-xh_/timg?image&quality=100&size=b4000_4000&sec=1589531790&di=8c9318780942cf59dda0cf30623ade6b&src=http://www.dachuantuan.com/uploadfile/2018/0129/20180129093127673.jpg)
   

   • 效果：

小声哔哔：后续文章出如何白嫖图床(图片服务器)

9. 列表

   • 有序列表

     有序列表使用符号 1., 2., 3. ... 开启有序列表

     1. 一级列表头
     2. 二级列表头
     3. 三级列表头
     ...
     

   • 无序列表

     无序列表用 -, +, * 任何一种都可以

     - 列表内容
     + 列表内容
     * 列表内容
     
     注意：- + * 跟内容之间都要有一个空格
     

   • 效果：

     1. 列表1
     2. 列表2
     3. 列表3
     • 无序列表1
     • 无序列表2
     • 无序列表3

   提醒: 有序和无序列表均可以嵌套使用，即可以在无序或有序的列表中的下级列表中继续使用

10. 表格

    Markdown 语法中使用表格语法:

    | 表头 | 表头 | 表头 |
    | :-: | :-: | :-:  |
    |行1列1|行1列2|行1列3|
    
    第二行分割表头和内容。
    - 有一个就行，为了对齐，多加了几个
    文字默认居左
    - 两边加：表示文字居中
    - 右边加：表示文字居右
    

    • 效果

      表头	表头	表头
      行1列1	行1列2	行1列3

11. 反斜杠 \

    相当于反转义的符号，将标记符号变成普通符号

    \**不变粗**
    

    • 效果：

      *不变粗*

12. 标记符号 '`'

    '`' 此符号起到标记作用
    eg: `标记一下`
    

    • 效果：

      标记你了

13. 流程图

    ​```flow
    st=>start: 开始
    op=>operation: My Operation
    cond=>condition: Yes or No?
    e=>end
    st->op->cond
    cond(yes)->e
    cond(no)->op
    ​```
    

    • 效果：

    st=>start: 开始
    op=>operation: My Operation
    cond=>condition: Yes or No?
    e=>end
    st->op->cond
    cond(yes)->e
    cond(no)->op
    

    注意：Markdown 的流程图语法在一些支持 Markdown 语法的网站或编辑器上不一定支持，或是它们有自己的实现 Markdown 流程图的语法