markdown常用语法使用笔记+使用技巧(持续更新......)

参考引用内容: 简书教程

一 基本语法

1. 标题

• 语法: 在想要设置为标题的文字前面加#来表示,一个#是一级标题，二个#是二级标题，以此类推。支持六级标题。
  注：标准语法一般在#后跟个空格再写文字
• 示例:

   # 这是一级标题
   ## 这是二级标题
   ### 这是三级标题
   #### 这是四级标题

• 效果:
  

---

2. 字体

• 语法:
  1. 粗体: 要加粗的文字左右分别用两个*号包起来
  2. 斜体: 要倾斜的文字左右分别用一个*号包起来
  3. 斜体加粗: 要倾斜和加粗的文字左右分别用三个*号包起来
  4. 删除线: 要加删除线的文字左右分别用两个~~号包起来
• 示例:

   **这是加粗的文字**
   *这是倾斜的文字*
   ***这是斜体加粗的文字***
   ~~这是加删除线的文字~~  

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

---

3. 引用

• 语法:
  在引用的文字前加>即可。引用也可以嵌套，如加两个>>三个>>>
• 示例:

   >这是引用的内容
   >>这是引用的内容
   >>>这是引用的内容

• 效果:

  这是引用的内容

  这是引用的内容

  这是引用的内容

---

4.分割线

用三个或者三个以上的 - 或者 * 或者 _ 表示,分割线会把两端内容分割成两段落,排版都会重新开始

• 示例:
  
• 效果:

---

分割线

---

分割线

---

分割线

---

5.图片

• 语法:

![图片alt](图片地址 ''图片title'')
或者使用img标签,可以调整大小
<img src="https://img2018.cnblogs.com/blog/1370059/202002/1370059-20200208164626513-340138758.png" width=60% height=60%  />

图片alt就是显示在图片下面的文字，相当于对图片内容的解释。
图片title是图片的标题，当鼠标移到图片上时显示的内容。title可加可不加

• 示例:

![美女](http://pic.netbian.com/uploads/allimg/190902/152344-1567409024d50f.jpg "性感图片")

• 效果:
  

---

6.超链接

• 语法:

[超链接名](超链接地址 "超链接title")
title可加可不加
或者直接生成链接: <https://gitee.com/houzheng1216>

• 示例:

[侯赛雷的码云地址](https://gitee.com/houzheng1216)
[侯赛雷的博客地址](https://www.cnblogs.com/houzheng/)
码云地址: <https://gitee.com/houzheng1216>

• 效果:
  侯赛雷的码云地址
  侯赛雷的博客地址
  码云地址: https://gitee.com/houzheng1216

---

7.列表

• 语法:
  无序列表用 - + * 任何一种都可以
  有序列表直接用数字即可,前面符号和数字序号需要跟后面内容有空格
  列表之间嵌套前面需要有 tab空格
• 示例:

1. 一级有序
   - 二级无序列表
      - 三级无序
      - 三级无序
   - 二级无序列表
   - 二级无序列表
2. 一级有序
   - 二级无序
   - 二级无序
3. 一级有序

• 效果:

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

---

8.表格

• 语法:

表头|表头|表头
---|:--:|---:
内容|内容|内容
内容|内容|内容

0) 第二行分割表头和内容。
1）|、-、:之间的多余空格会被忽略，不影响布局。
2）默认标题栏居中对齐，内容居左对齐。
3）-:表示内容和标题栏居右对齐，:-表示内容和标题栏居左对齐，:-:表示内容和标题栏居中对齐,-的数量至少有一个。
4）内容和|之间的多余空格会被忽略，每行第一个|和最后一个|可以省略。

• 示例效果:

表头	表头	表头	表头	表头
左对齐	居中	居中	居中居中	右对齐
左对齐左对齐	居中居中	居中居中	居中居中	右对齐右对齐

---

9.符号

• 反斜杠: 相当于反转义作用。使符号成为普通符号:
• 示例:

<font color=red>红色</font>
<font color=red>红色</font>
![图片](http://pic.netbian.com/uploads/allimg/190608/130131-1559970091ea9b.jpg)
![图片](http://pic.netbian.com/uploads/allimg/190608/130131-1559970091ea9b.jpg)

• 效果:
  红色

<font color=red>红色


---

10.代码

• 语法:
  单行代码使用``括起来
  多行代码使用 三个反引号包起来，且两边的反引号单独占一行
• 示例:

    `List<Integer> list = Lists.list(1, 2, 3);`
    ```
    @Test
    public void test01Intern(){
        String s = new String("1");//生成堆中对象和常量池中1,常量池中有1
        s.intern();
        String s2 = "1";// 返回常量池引用
        System.out.println(s == s.intern());// jdk1.6 false  jdk1.7以上 false
        System.out.println(s == s2);// jdk1.6 false  jdk1.7以上 false
    }
    ```

• 效果:
  List<Integer> list = Lists.list(1, 2, 3);

    @Test
    public void test01Intern(){
        String s = new String("1");//生成堆中对象和常量池中1,常量池中有1
        s.intern();
        String s2 = "1";// 返回常量池引用
        System.out.println(s == s.intern());// jdk1.6 false  jdk1.7以上 false
        System.out.println(s == s2);// jdk1.6 false  jdk1.7以上 false
    }

---

11.mermaid

官方文档教程
mermaid(直译:美人鱼)是Markdown风格的语法，用于生成流程图，序列图，类图，甘特图和git图.
美人鱼功能很强大,能够做的流程图特别多,有兴趣可以去看官方文档,比如做一个简单的流程图:

• 示例:

代码块开头必须加上mermaid
graph LR;
A --> B
B --> C
C --插入文字--> A

• 效果:

graph LR; A --> B B --> C C --插入文字--> A

或者再做一个类图:

```mermaid
classDiagram
      Animal <|-- Duck
      Animal <|-- Fish
      Animal <|-- Zebra
      Animal : +int age
      Animal : +String gender
      Animal: +isMammal()
      Animal: +mate()
      class Duck{
          +String beakColor
          +swim()
          +quack()
      }
      class Fish{
          -int sizeInFeet
          -canEat()
      }
      class Zebra{
          +bool is_wild
          +run()
      }
 ```

效果:

classDiagram Animal <|-- Duck Animal <|-- Fish Animal <|-- Zebra Animal : +int age Animal : +String gender Animal: +isMammal() Animal: +mate() class Duck{ +String beakColor +swim() +quack() } class Fish{ -int sizeInFeet -canEat() } class Zebra{ +bool is_wild +run() }

---

12.toc

直接在markdown文件第一行写上

目录

• 一 基本语法
  • 1. 标题
  • 2. 字体
  • 3. 引用
  • 4.分割线
  • 5.图片
  • 6.超链接
  • 7.列表
  • 8.表格
  • 9.符号
  • 10.代码
  • 11.mermaid
  • 12.toc
  • 13. 自定义样式
• 二 使用技巧

• 示例:

[toc]

博客园可以直接在设置里面自定义标题自动生成目录,就不用每次手动写了!

---

13. 自定义样式

可以使用html标签进行自定义文字大小颜色等等

• 示例:
  <font color=blue>蓝色字体</font>

• 效果:
  蓝色字体

---

二 使用技巧

1. 段落之间需要留空格,上下都要留空格,否则会视为同一段落,标题表格等排版会有影响
2. 如果不用空格,就要使用分割线,表示另起一段
3. 使用分割线的时候,必须与上面内容之间有空格才会起作用
4. 美人鱼很强大,但是更推荐xmind那类的软件,贼好用
5. 同一行文字,两个空格就会自动换行,不需要写其他br标签什么的
6. 画表格的时候上下都要空一行,否则不会显示