語雀Markdown完全指南

一、Markdown簡介

Markdown是一種輕量級標記語言，設計初衷是讓人們更容易書寫結構化的文檔，而不是讓人們更關注排版的問題。Markdown最初由約翰·格魯伯（John Gruber）於2004年創建，是一種以易讀、易寫的方式書寫文本的語法。

Markdown語言可以轉換成HTML、PDF等多種格式。Markdown語言的標記語法主要包括：標題、段落、列表、表格、代碼塊、鏈接、圖片等。語法簡單，但涵蓋了絕大多數文本排版所需的功能。

二、語雀Markdown概述

語雀是一個在線的文本編輯和協作平台。語雀支持Markdown語言，並針對Markdown進行了優化。相比於傳統的Markdown語法，語雀 Markdown 在語法上進行了一些擴展、優化，例如增加了插圖、公式、文檔目錄等高級功能，還支持各類自定義樣式和模板。

在語雀Markdown中，標題、段落、列表、表格等基本語法和一般的Markdown語法類似。下面我們來介紹一些語雀Markdown的特殊語法。

三、語雀Markdown特殊語法

1.文檔/目錄

語雀Markdown支持一鍵生成完備的文檔目錄，用戶在閱讀大文檔時可以快速定位到相關部分。在文檔中插入[TOC]標籤，語雀會自動生成該文檔下的全部標題，並按照層級關係列出，形成一個可聚合、可收縮的列表。如下是一份自動文檔目錄創建的示例:

# 標題1
## 標題1.1
### 標題1.1.1
# 標題2
## 標題2.1

在文本中插入[TOC]，語雀會自動生成文檔目錄：

[TOC]

2.表格

語雀Markdown對表格的支持也有所擴展，可以設置表格的列寬、對齊方式、背景色、單元格腳註等。下面我們來看一下如何在語雀Markdown中實現多種表格設定。

2.1 基本表格

| 左對齊 | 居中 | 右對齊 |
| :- | :-: | -: |
| a | b | c |
| aaa | bbb | ccc |

渲染效果如下：

| 左對齊 | 居中 | 右對齊 |
| :- | :-: | -: |
| a | b | c |
| aaa | bbb | ccc |

2.2 添加背景色

| 姓名 | 性別 | 年齡 |
| :--- | :---: | ---: |
| **張三** | 女 | `18` |
| 李四 | 男 | `20` |

渲染效果如下：

| 姓名 | 性別 | 年齡 |
| :— | :—: | —: |
| **張三** | 女 | `18` |
| 李四 | 男 | `20` |

2.3 設置單元格腳註

| 左對齊 | 居中 | 右對齊 |
| :- | :-: | -: |
| a | b | c |
| aaa | bbb | ccc[^1] |
[^1]: 這是註腳文字。

渲染效果如下：

| 左對齊 | 居中 | 右對齊 |
| :- | :-: | -: |
| a | b | c |
| aaa | bbb | ccc[^1] |

3.公式

語雀Markdown支持通過MathJax插件實現Latex公式的渲染。添加公式只需要將其寫在一對`$`符號之間，如 `$a^2 + b^2 = c^2$` 可渲染為：$a^2 + b^2 = c^2$。

如果需要在一行中輪廓多個公式，可以用 `$$` 符號，如 `$$a_{n+1} = a_n + d$$ $$S_n = \frac{(a_1 + a_n)n}{2}$$` 可渲染為：

$$a_{n+1} = a_n + d$$$$S_n = \frac{(a_1 + a_n)n}{2}$$

4.流程圖和時序圖

在語雀Markdown中，也支持通過Mermaid的較簡短語法實現流程圖和時序圖的渲染。

4.1 流程圖

```mermaid
graph TD;
A-->B;
A-->C;
B-->D;
C-->D;
```

渲染效果如下：

“`mermaid
graph TD;
A–>B;
A–>C;
B–>D;
C–>D;
“`

4.2 時序圖

```mermaid
sequenceDiagram
A->>B: 請求登錄
B->>C: 驗證參數
C->>D: 查詢許可權
alt 許可權通過
D-->>B: 返回token
else 許可權失敗
D-->>A: 返回錯誤信息
end
```

渲染效果如下：

“`mermaid
sequenceDiagram
A->>B: 請求登錄
B->>C: 驗證參數
C->>D: 查詢許可權
alt 許可權通過
D–>>B: 返回token
else 許可權失敗
D–>>A: 返回錯誤信息
end
“`

總結

語雀Markdown作為一種輕量級標記語言，兼具Markdown語法的簡單明了、易讀易寫的特點，並為用戶提供了更多的擴展功能。熟練掌握語雀Markdown的語法和特性不僅可以大幅度提升文檔編寫的效率，還可以讓你獲得一個簡潔、清晰、美觀的文檔。