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. 一级有序

效果:

一级有序
- 二级无序列表
  - 三级无序
  - 三级无序
- 二级无序列表
- 二级无序列表
一级有序
- 二级无序
- 二级无序
一级有序

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>红色

![图片](http://pic.netbian.com/uploads/allimg/190608/130131-1559970091ea9b.jpg)

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>
效果:

蓝色字体

二使用技巧

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