Markdown基本語法與高級特性教程:編寫格式豐富文檔的必備指南

2025-01-10 16:29 更新

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

標題

使用#來表示標題。一個#表示最大的標題(相當于HTML的<h1>),六個#表示最小的標題(相當于HTML的<h6>)。

## 最大標題
## 次級標題
### 第三級標題
... 以此類推
###### 最小標題

強調(diào)

使用*_來強調(diào)文本。

*這段文字會顯示為斜體*
_這段文字也會顯示為斜體_


**這段文字會顯示為粗體**
__這段文字也會顯示為粗體**


~~這段文字會顯示為刪除線~~

列表

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

- 列表項一
- 列表項二
  - 子列表項一
  - 子列表項二
+ 第二個列表項
* 第三個列表項

有序列表使用數(shù)字后跟點來創(chuàng)建:

1. 第一項
2. 第二項
3. 第三項

鏈接

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

[點擊這里訪問Google](https://www.google.com)

圖片

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

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

代碼

使用反引號來標記代碼。

`alert("Hello World!");`

對于代碼塊,使用三個反引號:

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

引用

使用>來創(chuàng)建引用。

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

表格

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

| 標題1 | 標題2 | 標題3 |
|-------|-------|-------|
| 單元格1 | 單元格2 | 單元格3 |
| 單元格4 | 單元格5 | 單元格6 |

任務(wù)列表

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

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

轉(zhuǎn)義字符

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

\*這不是斜體\*

分隔線

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

---


或者


***


---

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

除了基本語法,Markdown的功能遠不止于此。以下是一些更高級的Markdown特性和示例,掌握這些特性和用法,讓你的文檔一直編寫一直爽。

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

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

<div>這是一個div元素</div>
<span>這是一個span元素</span>

塊引用

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

> 這是一個引用塊。
>
> 你可以在引用塊中使用Markdown語法,包括標題、列表等。

鏈接和圖片的標題

鏈接和圖片可以包含一個可選的標題作為工具提示。

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

腳注

一些Markdown解析器支持腳注,盡管這不是標準的Markdown語法。

這是一個腳注的例子[^1]


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

折疊內(nèi)容

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

<details>
  <summary>點擊展開/折疊</summary>

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

表格擴展語法

一些Markdown解析器支持更復雜的表格語法,包括對齊和分隔行。

| 左對齊 | 居中  | 右對齊 |
| :------ | :---: | ------: |
| 單元格  | 單元格 |  單元格 |
| 單元格  | 單元格 |  單元格 |

定義列表

定義列表在標準的Markdown中不被支持,但在一些變體中可以使用。

項目1
:   定義1


項目2
:   定義2

流程圖和序列圖

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

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

## 標記和刪除線
在一些Markdown解析器中,你可以使用`==`或`~~`來標記文本或刪除線文本。


```markdown
這里是==標記的文本==


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

高亮

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

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

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

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

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

V 哥提醒需要注意哦,并非所有的Markdown解析器都支持上述所有特性,特別是那些非標準的擴展特性。在使用時,你需要確認你的Markdown解析器或編輯器是否支持這些特性。

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

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

掃描二維碼

下載編程獅App

公眾號
微信公眾號

編程獅公眾號