Markdown快速入門教程

版權聲明：本文爲 Fly_liuhao 原創文章，非商用自由轉載-保持署名-註明出處，謝謝！
本文網址：https://blog.csdn.net/Fly_1213/article/details/85263430

Markdown網站應用

• GitHub
• Gitee
• GitBook
• CSDN
• 簡書
• 有道雲筆記

Markdown編輯器工具

編輯器(軟件)

• Typora
• Haroopad
• VsCode
• Atom
• Sublime Text

在線編輯

• Markable.in
• Dillinger.io
• CSDN
• 簡書
• 有道雲筆記

Markdown常用語法使用規則

1. 標題

• 通過 1 到 6 個 # ，對應到 1 到 6 級標題；
• 在一個文檔中，儘量保證有且僅有一個一級標題；
• 標題應該按照順序逐級遞增，不要跨級；
• 標題名稱不應該重複；
• 注意：【’#’ + ‘空格’ 】爲正確格式；

  # 一級標題
  ## 二級標題
  ### 三級標題
  #### 四級標題
  ##### 五級標題
  ###### 六級標題
  

---

2. 區塊引用 Blockquotes

• 區塊引用使用類似 email 中用 > 的引用方式；
• 區塊引用可以嵌套，只要根據層次加上不同數量的 >；
• 引用的區塊內也可以使用其他 Markdown 語法；
• 注意：【’>’ + ‘空格’】爲正確格式；

  > [RoboMaster機甲大師賽](https://www.robomaster.com/zh-CN)
  >> 機器人大賽
  >> 機器人夏令營
  >> 文化周邊
  >> 論壇
  

  效果：

  RoboMaster機甲大師賽

  機器人大賽
  機器人夏令營
  文化周邊
  論壇

  ---

3. 列表

• 無序列表使用 星號*、加號+ 或是 減號-(推薦) 作爲列表標記；
• 有序列表則使用數字接着一個英文句點；
• 列表可以包含多個段落，每個項目下的段落都必須具備相同縮進；
• 注意：【‘1.’ + ‘空格’】或【’-’ + ‘空格’】爲正確格式；

     - Red
       1. Dark Red
       2. Light Red
     - Green
       - Light Green
       - Dark Green
     - Blue
  

  效果：
  • Red
  1. Dark Red
  2. Light Red
  • Green
    • Light Green
    • Dark Green
  • Blue

---

4. 代碼區塊

• Markdown 會用 來把代碼區塊包起來;- Markdown 會用來把代碼區塊包起來;
• 建立代碼區塊時建議指定代碼語言;

  代碼塊支持的語言

  ```java
  public static void main(String[] args){
      System.out.println("Hello World!");
  }
  ```(Java代碼格式)
  

  ```python
  print('Hello','Python','World!')
  ```(Python代碼格式)
  

  Java效果：

  public static void main(String[] args){
     System.out.println("Hello World!");
  }
  

  Python效果：

  print('Hello','Python','World!')
  

---

5. 分隔線

• 可以在一行中用三個以上的星號 * 建立一個分隔線;
• 可以在一行中用三個以上的負號 - 建立一個分隔線;
• 可以在一行中用三個以上的下劃線 _ 建立一個分隔線;

   eg:
    	  ***
    	  ---
    	  ___
  

  效果：

  ---

  ---

  ---

---

6. 超鏈接

• 建立一個鏈接的語法是：[鏈接名稱](鏈接地址)

  eg: [RoboMaster](https://www.robomaster.com/zh-CN)
  

  效果：
  RoboMaster

---

7. 強調

• 用一個星號*作爲斜體標記;
• 用兩個星號 **作爲加粗標記;
• 用三個星號***作爲斜體加粗標記;
• 用兩個~~ 作爲刪除標記;

  eg:
      *這是傾斜的文字*
      **這是加粗的文字**
      ***這是斜體加粗的文字***
      ~~這是加刪除線的文字~~
  

  效果：
  這是傾斜的文字
  這是加粗的文字
  這是斜體加粗的文字
  這是加刪除線的文字

---

8. 行內代碼

• 如果要標記一小段行內代碼，可以用反引號把它包起來；

  eg: 我們可以在這裏使用 `int n = 3;` 行內代碼
  

  效果：
  我們可以在這裏使用 int n = 3; 行內代碼

---

9. 複選框

• 可以使用複選框- [ ] XXX來標註某個項目各項任務的完成情況；
• 注意【’-’ + ‘空格’ + ‘[ ]’ + 名稱】爲正確格式，- [x] XXX爲默認勾選；

  - [x] 軟件工程
  - [ ] 網絡工程
  - [ ] 計算機科學與技術
  

  效果：
  • 軟件工程
  • 網絡工程
  • 計算機科學與技術

---

10. 圖片

• 可以使用下面的代碼嵌入圖片：[外鏈圖片轉存失敗(img-b7zhS2NY-1562503283931)(文件地址 "可選提示文本")]

  eg: [外鏈圖片轉存失敗(img-ZaJb6m2g-1562503283935)(https://rm-static.djicdn.com/robomasters/public/img/gold.ef61d5e.png "冠軍獎盃")]
  

  效果：
  [外鏈圖片轉存失敗(img-4oIkaO93-1562503283937)(https://rm-static.djicdn.com/robomasters/public/img/gold.ef61d5e.png “冠軍獎盃”)]

---

11. 表格

• 語法中第二行分割表頭和內容;
• 有一個-就行，爲了對齊，多加了幾個;
• 文字默認居左|--|;
• 左邊加:表示文字居左|:--|;
• 兩邊加:表示文字居中|:--:|;
• 右邊加:表示文字居右|--:|;

  表頭|表頭|表頭
  :--|:--:|--:
  內容|內容|內容
  內容|內容|內容
  

  效果：（靠左，居中，居右）

  號	姓名	愛好
  1	張三	學習
  123	李四	打籃球
  123456	王小五	喫飯睡覺

---

12. 特殊符號處理

• Markdown使用反斜槓\插入語法中用到的特殊符號，在Markdown中，主要有以下幾種特殊符號需要處理：

  \\   反斜線
  \`   反引號
  \*   星號
  \_   底線
  \{}  花括號
  \[]  方括號
  \()  括弧
  \#   井字號
  \+`  加號
  \-   減號
  \.   英文句點
  \!   驚歎號
  

  eg:計算：x \+ 5 \> 10中 x 的取值範圍;
  效果:
  計算：x + 5 > 10中 x 的取值範圍;

其他效果設置（使用Html語言）

1. 換行
   <br/>
2. 首行縮進
   
3. 修改字體顏色
   <font color=blue > blue </font>
   效果： blue
   <font color=#00f9ff > #00f9ff </font>
   效果： #00f9ff
4. 修改字體
   <font face="微軟雅黑"> 微軟雅黑</font>
   效果： 微軟雅黑
   <font face="黑體"> 黑體</font>
   效果： 黑體
   <font face="宋體"> 宋體</font>
   效果： 宋體
   <font face="楷體"> 楷體</font>
   效果： 楷體
   <font face="STCAIYUN"> 華文彩雲</font>
   效果： 華文彩雲
5. 修改字號 (注：取值範圍是 1 到 7,瀏覽器默認值是 3)
   <font size=5 > 5號字體 </font>
   示例結果： 5號字體
6. 修改文本背景色
   <table><tr><td bgcolor=gray>這一行顯示的背景色是灰色</td></tr></table>
   效果：

   這一行顯示的背景色是灰色

   
   <table><tr><td bgcolor=pink>這一行顯示的背景色是粉色</td></tr></table>
   效果：

   這一行顯示的背景色是粉色