Markdown基本语法和扩展语法

矫情吗；* 2024-03-23 17:21 64阅读 0赞

## 一、Markdown基本语法 ##

### 1、标题语法 ###

要创建标题，请在单词或短语前面添加井号 (\#) 。\# 的数量代表了标题的级别。例如，添加三个 \# 表示创建一个三级标题 (<h3>) (例如：\#\#\# My Header)。

<table> 
 <thead> 
  <tr> 
   <th>Markdown语法</th> 
   <th>HTML</th> 
   <th>预览效果</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td># Heading level 1</td> 
   <td>&lt;h1&gt;Heading level 1&lt;/h1&gt;</td> 
   <td><h2>Heading level 1</h2></td> 
  </tr> 
  <tr> 
   <td>## Heading level 2</td> 
   <td>&lt;h2&gt;Heading level 2&lt;/h2&gt;</td> 
   <td><h3>Heading level 2</h3></td> 
  </tr> 
  <tr> 
   <td>### Heading level 3</td> 
   <td>&lt;h3&gt;Heading level 3&lt;/h3&gt;</td> 
   <td><h4>Heading level 3</h4></td> 
  </tr> 
  <tr> 
   <td>#### Heading level 4</td> 
   <td>&lt;h4&gt;Heading level 4&lt;/h4&gt;</td> 
   <td><h5>Heading level 4</h5></td> 
  </tr> 
  <tr> 
   <td>##### Heading level 5</td> 
   <td>&lt;h5&gt;Heading level 5&lt;/h5&gt;</td> 
   <td><h6>Heading level 5</h6></td> 
  </tr> 
  <tr> 
   <td>###### Heading level 6</td> 
   <td>&lt;h6&gt;Heading level 6&lt;/h6&gt;</td> 
   <td><h6>Heading level 6</h6></td> 
  </tr> 
 </tbody> 
</table>

#### 1.1可选语法 ####

--------------------

还可以在文本下方添加任意数量的 == 号来标识一级标题，或者 – 号来标识二级标题。

<table> 
 <thead> 
  <tr> 
   <th>Markdown语法</th> 
   <th>HTML</th> 
   <th>预览效果</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>Heading level 1<br>============</td> 
   <td>&lt;h1&gt;Heading level 1&lt;/h1&gt;</td> 
   <td><h2>Heading level 1</h2></td> 
  </tr> 
  <tr> 
   <td>Heading level 2<br>---------------------</td> 
   <td>&lt;h2&gt;Heading level 2&lt;/h2&gt;</td> 
   <td><h3>Heading level 2</h3></td> 
  </tr> 
 </tbody> 
</table>

#### 1.2最佳实践 ####

--------------------

不同的 Markdown 应用程序处理 \# 和标题之间的空格方式并不一致。为了兼容考虑，请用一个空格在 \# 和标题之间进行分隔。

<table> 
 <thead> 
  <tr> 
   <th>✅ Do this</th> 
   <th>❌ Don’t do this</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td># Here’s a Heading</td> 
   <td>#Here’s a Heading</td> 
  </tr> 
 </tbody> 
</table>

### 2、段落语法 ###

![在这里插入图片描述][53409902aec64ee49604945672a89ac2.png_pic_center]

#### 2.1最佳实践 ####

--------------------

![在这里插入图片描述][1d72cfbfe44c450fa5f154b8164740c7.png_pic_center]

### 3、换行语法 ###

![在这里插入图片描述][9e252ea7ac3143368cf78907389f133a.png_pic_center]

#### 3.1最佳实践 ####

--------------------

![在这里插入图片描述][ceeb21a12f3d4015a729773eee1aaf25.png_pic_center]

### 4、强调语法 ###

通过将文本设置为粗体或斜体来强调其重要性。

#### 4.1 粗体（Bold） ####

--------------------

要加粗文本，请在单词或短语的前后各添加两个星号（asterisks）或下划线（underscores）。如需加粗一个单词或短语的中间部分用以表示强调的话，请在要加粗部分的两侧各添加两个星号（asterisks）。

<table> 
 <thead> 
  <tr> 
   <th>Markdown语法</th> 
   <th>HTML</th> 
   <th>预览效果</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>I just love **bold text**.</td> 
   <td>I just love &lt;strong&gt;bold text&lt;/strong&gt;.</td> 
   <td>I just love <strong>bold text</strong>.</td> 
  </tr> 
  <tr> 
   <td>I just love _<em>bold text</em>_.</td> 
   <td>I just love &lt;strong&gt;bold text&lt;/strong&gt;.</td> 
   <td>I just love <strong>bold text</strong>.</td> 
  </tr> 
  <tr> 
   <td>Love**is**bold</td> 
   <td>Love&lt;strong&gt;is&lt;/strong&gt;bold</td> 
   <td>Love<strong>is</strong>bold</td> 
  </tr> 
 </tbody> 
</table>

##### 4.1.1 最佳实践 #####

Markdown 应用程序在如何处理单词或短语中间的下划线上并不一致。为兼容考虑，在单词或短语中间部分加粗的话，请使用星号（asterisks）。

#### 4.2 斜体（Italic） ####

--------------------

要用斜体显示文本，请在单词或短语前后添加一个星号（asterisk）或下划线（underscore）。要斜体突出单词的中间部分，请在字母前后各添加一个星号，中间不要带空格。  
![在这里插入图片描述][4b092000276142fc82501ac65040db86.png_pic_center]

##### 4.2.1 最佳实践 #####

要同时用粗体和斜体突出显示文本，请在单词或短语的前后各添加三个星号或下划线。要加粗并用斜体显示单词或短语的中间部分，请在要突出显示的部分前后各添加三个星号，中间不要带空格。

#### 4.3 粗体（Bold）和斜体（Italic） ####

--------------------

要同时用粗体和斜体突出显示文本，请在单词或短语的前后各添加三个星号或下划线。要加粗并用斜体显示单词或短语的中间部分，请在要突出显示的部分前后各添加三个星号，中间不要带空格。  
![在这里插入图片描述][50aab5e98abb424084fa7238d96868d5.png_pic_center]

##### 4.3.1 最佳实践 #####

<table> 
 <thead> 
  <tr> 
   <th>✅ Do this</th> 
   <th>❌ Don’t do this</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>This is really***very***important text.</td> 
   <td>This is really___very___important text.</td> 
  </tr> 
 </tbody> 
</table>

### 5、引用语法 ###

要创建块引用，请在段落前添加一个 > 符号。

> Dorothy followed her through many of the beautiful rooms in her castle.

渲染效果如下所示：

> Dorothy followed her through many of the beautiful rooms in her castle.

#### 5.1 多个段落的块引用 ####

--------------------

块引用可以包含多个段落。为段落之间的空白行添加一个 > 符号。

> Dorothy followed her through many of the beautiful rooms in her castle.
    >
    > The Witch bade her clean the pots and kettles and sweep the floor and keep the fire fed with wood.

渲染效果如下：

> Dorothy followed her through many of the beautiful rooms in her castle.
> 
> The Witch bade her clean the pots and kettles and sweep the floor and keep the fire fed with wood.

#### 5.2 嵌套块引用 ####

--------------------

块引用可以嵌套。在要嵌套的段落前添加一个 >> 符号。

> Dorothy followed her through many of the beautiful rooms in her castle.
    >
    >> The Witch bade her clean the pots and kettles and sweep the floor and keep the fire fed with wood.

渲染效果如下：

> Dorothy followed her through many of the beautiful rooms in her castle.
> 
> > The Witch bade her clean the pots and kettles and sweep the floor and keep the fire fed with wood.

#### 5.3 带有其它元素的块引用 ####

--------------------

块引用可以包含其他 Markdown 格式的元素。并非所有元素都可以使用，你需要进行实验以查看哪些元素有效。

> #### The quarterly results look great!
    >
    > - Revenue was off the chart.
    > - Profits were higher than ever.
    >
    >  *Everything* is going according to **plan**.

渲染效果如下：

> ##### The quarterly results look great! #####
> 
>  *  Revenue was off the chart.
>  *  Profits were higher than ever.
> 
> *Everything* is going according to **plan**.

### 6、列表语法 ###

可以将多个条目组织成有序或无序列表。

#### 6.1有序列表 ####

--------------------

要创建有序列表，请在每个列表项前添加数字并紧跟一个英文句点。数字不必按数学顺序排列，但是列表应当以数字 1 起始。  
![在这里插入图片描述][9b49752579ac4c98ad68910784513e9c.png_pic_center]

#### 6.1.1 有序列表最佳实践 ####

CommonMark and a few other lightweight markup languages let you use a parenthesis ()) as a delimiter (e.g., 1) First item), but not all Markdown applications support this, so it isn’t a great option from a compatibility perspective. For compatibility, use periods only.

<table> 
 <thead> 
  <tr> 
   <th>✅ Do this</th> 
   <th>❌ Don’t do this</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>1. First item<br>2. Second item</td> 
   <td>1) First item<br>2) Second item</td> 
  </tr> 
 </tbody> 
</table>

### 6.2 无序列表 ###

--------------------

要创建无序列表，请在每个列表项前面添加破折号 (-)、星号 (\*) 或加号 (+) 。缩进一个或多个列表项可创建嵌套列表。  
![在这里插入图片描述][40d4a05b5943411ebd3ddb49d6471122.png_pic_center]

> Markdown 官方教程: [https://markdown.com.cn/][https_markdown.com.cn]

[53409902aec64ee49604945672a89ac2.png_pic_center]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/14/27651f7688834923acd4c86e2c7fa163.png
[1d72cfbfe44c450fa5f154b8164740c7.png_pic_center]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/14/314b477620c043d4bf2e2f104e75d9ee.png
[9e252ea7ac3143368cf78907389f133a.png_pic_center]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/14/b35658b8409248d9a6b7b864b2777276.png
[ceeb21a12f3d4015a729773eee1aaf25.png_pic_center]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/14/246623f429ab42279ac6dbe28ed8f49e.png
[4b092000276142fc82501ac65040db86.png_pic_center]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/14/a06ef1fe81744ba4b37c43e6f13c30d3.png
[50aab5e98abb424084fa7238d96868d5.png_pic_center]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/14/cb6aff2a9c7546bc94605ae6b4bae31c.png
[9b49752579ac4c98ad68910784513e9c.png_pic_center]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/14/116a7e91bcb348bfad53b05e5a67e554.png
[40d4a05b5943411ebd3ddb49d6471122.png_pic_center]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/14/a1fc82badad64524b16f128d8763ae1b.png
[https_markdown.com.cn]: https://markdown.com.cn/