Markdown基本語(yǔ)法與高級(jí)特性教程:編寫(xiě)格式豐富文檔的必備指南

2025-01-10 16:18 更新

Markdown是一種輕量級(jí)的標(biāo)記語(yǔ)言,它允許人們使用易讀易寫(xiě)的純文本格式編寫(xiě)文檔,然后轉(zhuǎn)換成結(jié)構(gòu)化的HTML。以下是Markdown的一些基本語(yǔ)法和示例:

標(biāo)題

使用#來(lái)表示標(biāo)題。一個(gè)#表示最大的標(biāo)題(相當(dāng)于HTML的<h1>),六個(gè)#表示最小的標(biāo)題(相當(dāng)于HTML的<h6>)。

## 最大標(biāo)題
## 次級(jí)標(biāo)題
### 第三級(jí)標(biāo)題
... 以此類推
###### 最小標(biāo)題

強(qiáng)調(diào)

使用*_來(lái)強(qiáng)調(diào)文本。

*這段文字會(huì)顯示為斜體*
_這段文字也會(huì)顯示為斜體_


**這段文字會(huì)顯示為粗體**
__這段文字也會(huì)顯示為粗體**


~~這段文字會(huì)顯示為刪除線~~

列表

使用-, +, 或 *創(chuàng)建無(wú)序列表。

- 列表項(xiàng)一
- 列表項(xiàng)二
  - 子列表項(xiàng)一
  - 子列表項(xiàng)二
+ 第二個(gè)列表項(xiàng)
* 第三個(gè)列表項(xiàng)

有序列表使用數(shù)字后跟點(diǎn)來(lái)創(chuàng)建:

1. 第一項(xiàng)
2. 第二項(xiàng)
3. 第三項(xiàng)

鏈接

使用[]()來(lái)創(chuàng)建鏈接。

[點(diǎn)擊這里訪問(wèn)Google](https://www.google.com)

圖片

使用![]()來(lái)插入圖片。

![替代文本](https://www.example.com/image.jpg "可選的標(biāo)題")

代碼

使用反引號(hào)來(lái)標(biāo)記代碼。

`alert("Hello World!");`

對(duì)于代碼塊,使用三個(gè)反引號(hào):

```javascript
function example() {
  console.log("這是一個(gè)代碼塊示例");
}

### 引用
使用`>`來(lái)創(chuàng)建引用。


```markdown
> 這是一段引用文本
> 可以包含多行
>
> 第二段引用文本

表格

使用|---來(lái)創(chuàng)建表格。

| 標(biāo)題1 | 標(biāo)題2 | 標(biāo)題3 |
|-------|-------|-------|
| 單元格1 | 單元格2 | 單元格3 |
| 單元格4 | 單元格5 | 單元格6 |

任務(wù)列表

使用- [ ]- [x]來(lái)創(chuàng)建任務(wù)列表。

- [ ] 未完成的任務(wù)
- [x] 已完成的任務(wù)

轉(zhuǎn)義字符

使用反斜杠\來(lái)轉(zhuǎn)義Markdown中的特殊字符。

\*這不是斜體\*

分隔線

使用三個(gè)或更多的*, ---___來(lái)創(chuàng)建分隔線。

---


或者


***


---

這些是Markdown的一些基本語(yǔ)法。使用這些語(yǔ)法可以創(chuàng)建格式豐富的文檔,并且它們可以很容易地被轉(zhuǎn)換成HTML格式。

除了基本語(yǔ)法,Markdown的功能遠(yuǎn)不止于此。以下是一些更高級(jí)的Markdown特性和示例,掌握這些特性和用法,讓你的文檔一直編寫(xiě)一直爽。

內(nèi)聯(lián)HTML

Markdown支持內(nèi)聯(lián)HTML,這意味著你可以在Markdown文檔中直接使用HTML標(biāo)簽。

<div>這是一個(gè)div元素</div>
<span>這是一個(gè)span元素</span>

塊引用

塊引用可以用于創(chuàng)建引用塊,通常用于引用文本或代碼。

> 這是一個(gè)引用塊。
>
> 你可以在引用塊中使用Markdown語(yǔ)法,包括標(biāo)題、列表等。

鏈接和圖片的標(biāo)題

鏈接和圖片可以包含一個(gè)可選的標(biāo)題作為工具提示。

[這是一個(gè)鏈接](https://www.example.com "鏈接標(biāo)題")
![這是一張圖片](https://www.example.com/image.jpg "圖片標(biāo)題")

腳注

一些Markdown解析器支持腳注,盡管這不是標(biāo)準(zhǔn)的Markdown語(yǔ)法。

這是一個(gè)腳注的例子[^1]


[^1]: 這是腳注的內(nèi)容。

折疊內(nèi)容

一些Markdown編輯器支持折疊內(nèi)容,允許你隱藏或展開(kāi)部分文本。

<details>
  <summary>點(diǎn)擊展開(kāi)/折疊</summary>

  
  這里是可以被折疊的內(nèi)容...
</details>

表格擴(kuò)展語(yǔ)法

一些Markdown解析器支持更復(fù)雜的表格語(yǔ)法,包括對(duì)齊和分隔行。

| 左對(duì)齊 | 居中  | 右對(duì)齊 |
| :------ | :---: | ------: |
| 單元格  | 單元格 |  單元格 |
| 單元格  | 單元格 |  單元格 |

定義列表

定義列表在標(biāo)準(zhǔn)的Markdown中不被支持,但在一些變體中可以使用。

項(xiàng)目1
:   定義1


項(xiàng)目2
:   定義2

流程圖和序列圖

一些Markdown解析器支持Mermaid語(yǔ)法,可以創(chuàng)建流程圖和序列圖。

```mermaid
graph LR
A[開(kāi)始] --> B{決策}
B -- 是 --> C[結(jié)果1]
B -- 否 --> D[結(jié)果2]

### 標(biāo)記和刪除線
在一些Markdown解析器中,你可以使用`==`或`~~`來(lái)標(biāo)記文本或刪除線文本。


```markdown
這里是==標(biāo)記的文本==


這里是~~刪除線的文本~~

高亮

一些Markdown編輯器支持文本高亮。

==這段文本將被高亮==

行內(nèi)屬性(如字體大小和顏色)

一些Markdown解析器支持行內(nèi)屬性,如改變字體大小或顏色。

*小型*、**中型**、***大型***
~~紅色文本~~{: .red}

V 哥提醒需要注意哦,并非所有的Markdown解析器都支持上述所有特性,特別是那些非標(biāo)準(zhǔn)的擴(kuò)展特性。在使用時(shí),你需要確認(rèn)你的Markdown解析器或編輯器是否支持這些特性。

好了,以上這些特性,覺(jué)對(duì)可以滿足你編寫(xiě)Markdown(md)的需要。歡迎關(guān)注威哥愛(ài)編程,分享更多技術(shù)知識(shí)。

以上內(nèi)容是否對(duì)您有幫助:
在線筆記
App下載
App下載

掃描二維碼

下載編程獅App

公眾號(hào)
微信公眾號(hào)

編程獅公眾號(hào)