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）內容和|之間的多余空格會被忽略，每行第一個|和最后一個|可以省略。

• 示例效果:

表頭	表頭	表頭	表頭	表頭
左對齊	居中	居中	居中居中	右對齊
左對齊左對齊	居中居中	居中居中	居中居中	右對齊右對齊

markdown雖然不支持表格嵌套，但是他支持html，所以可以使用HTML實現表格嵌套：
比如代碼：

<table>
    <caption><b>品牌選擇</b></caption>
	<tr>
	    <th>相機種類</th>
	    <th>品牌</th>
	    <th>特點</th>  
	</tr>
	<tr>
	    <td rowspan="2">單反</td>
	    <td>佳能</td>
	    <td rowspan="2">兩個品牌都可以，都很好，沒明顯區別</td>
	</tr>
	<tr>
	    <td>尼康</td>
	</tr>
	<tr>
	    <td rowspan="3">微單</td>
            <td>奧林巴斯</td>
	    <td colspan="2">防抖強悍，波輪按鈕多，不用都操作屏幕</td>
	</tr>
        <tr>
            <td>富士</td>
	    <td colspan="2">色彩漂亮，照片真實</td>
	</tr>
        <tr>
            <td>索尼</td>
	    <td colspan="2">畫質好</td>
	</tr>
	<tr>
	    <td rowspan="2">旁軸</td>
	    <td>徠卡</td>
	    <td rowspan="2">旁軸功能較少，不推薦使用</td>
	</tr>
      <tr>
	    <td>富士</td>
	</tr>
	<tr>
	    <td rowspan="1">中畫幅相機</td>
	    <td>哈蘇</td>
	    <td>中畫幅就選哈蘇，相機之王</td>
	</tr>
</table>

嵌套效果：

品牌選擇

相機種類	品牌	特點
單反	佳能	兩個品牌都可以，都很好，沒明顯區別
	尼康
微單	奧林巴斯	防抖強悍，波輪按鈕多，不用都操作屏幕
	富士	色彩漂亮，照片真實
	索尼	畫質好
旁軸	徠卡	旁軸功能較少，不推薦使用
	富士
中畫幅相機	哈蘇	中畫幅就選哈蘇，相機之王

---

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. 自定義樣式
  • 14 視頻
• 二 使用技巧

• 示例:

[toc]

博客園可以直接在設置里面自定義標題自動生成目錄,就不用每次手動寫了!

---

13. 自定義樣式

可以使用html標簽進行自定義文字大小顏色等等

• 示例:
  <font color=blue>藍色字體</font>

• 效果:
  藍色字體

---

14 視頻

<iframe width="720" height="405" frameborder="0" src="https://www.ixigua.com/iframe/6983530617128518177?autoplay=0" referrerpolicy="unsafe-url" allowfullscreen></iframe>

二 使用技巧

1. 段落之間需要留空格,上下都要留空格,否則會視為同一段落,標題表格等排版會有影響
2. 如果不用空格,就要使用分割線,表示另起一段
3. 使用分割線的時候,必須與上面內容之間有空格才會起作用
4. 美人魚很強大,但是更推薦xmind那類的軟件,賊好用
5. 同一行文字,兩個空格就會自動換行,不需要寫其他br標簽什么的
6. 畫表格的時候上下都要空一行,否則不會顯示