Markdown 語法規(guī)則及寫作工具

Markdown 是一種輕量級標記語言，通過簡單符號實現(xiàn)文本格式化。相對于 LaTeX 這類專業(yè)的排版語言，Markdown 更簡單易用，適用于筆記，博客等場景。

Markdown 的語法規(guī)則較為簡單，但不同的 Markdown 解析器對語法的支持可能有所不同，本文僅對基礎語法進行簡單的介紹，并介紹一些常用的 Markdown 寫作工具。

Markdown 語法規(guī)則

標題

使用#表示，數(shù)量對應級別。

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

文本樣式

• ? 加粗：**加粗文本** 或 __加粗文本__ → 加粗文本
• ? 斜體：*斜體文本* 或 _斜體文本_ → 斜體文本
• ? 粗斜體：***粗斜體文本*** 或 ___粗斜體文本___ → 粗斜體文本
• ? 刪除線：~~刪除線文本~~ →刪除線文本
• ? 轉義字符：使用\輸出特殊符號，例如：\* 這不是斜體 \* → * 這不是斜體 *
• ? 引用：使用 > 表示：> 引用文本 →

  引用文本

• ? 分割線：三個或更多 * 、 - 或 _，例如 ***，---，___ →

---

列表

無序列表

使用 -、* 或 +，示例：

- 項目1
- 項目2
  - 子項目

有序列表

使用數(shù)字加點，示例：

1. 第一項
2. 第二項
  1. 子項

任務列表

使用- [x] 和 - [ ]，示例：

- [x] 已完成任務
- [ ] 待辦任務

圖片

圖片的格式可表示為![顯示文本](圖片地址或鏈接)，顯示文本在圖片無法加載時顯示?？梢允褂帽镜貓D片地址，也可使用圖床生成鏈接。

表格

使用 | 和 - 創(chuàng)建，使用 : 改變對齊方式，示例：

默認對齊	左對齊	居中對齊	右對齊
單元格內容	單元格內容	單元格內容	單元格內容

| 默認對齊 | 左對齊 | 居中對齊 | 右對齊 |
| --- | :--- | :---: | ---: |
| 單元格內容 | 單元格內容 | 單元格內容 | 單元格內容 |

代碼

• ? 行內代碼： `inline code`  → inline code
• ? 代碼塊：三個反引號包裹，可指定語言，若需要在代碼塊內輸入三個反引號，則代碼塊的界定符需比內部使用更多的反引號：

```python
print("Hello, Markdown!")
```

數(shù)學公式

支持 LaTeX 語法，需依賴 MathJax 或 KaTeX 渲染。

• ? 行內公式：$y = x^2$ → 
• ? 行間公式：$$e^{i\theta} = \cos(\theta) + i\sin(\theta)$$ →
  
• ? 在行間公式嵌入 LaTeX 公式環(huán)境，示例：

$$
\begin{equation}
  |x| = 
    \begin{cases}
      x & \text{if } x \geq 0 \\
      -x & \text{if } x < 0
    \end{cases}
\end{equation}
$$

• ? 使用 \tag{} 命令為公式手動指定一個編號或標記，用于公式的引用和說明，\tag*{} 命令可以去除包圍標簽的圓括號，在引用公式時，標簽需手動輸入，示例：

$$
\begin{equation}
    \begin{split}
        e^x &= \sum_{n=0}^{\infty} \frac{x^n}{n!}  \\
        &= 1 + x + \frac{x^2}{2!} + \frac{x^3}{3!} + \cdots + \frac{x^n}{n!} + \cdots
    \end{split}
\end{equation}
\tag*{1-1}
$$

鏈接

行內鏈接

行內鏈接直接在行內定義鏈接的文本和地址。其格式可表示為[顯示文本](鏈接地址 "可選標題")，顯示文本 是頁面上顯示的文字，鏈接地址 是鏈接的實際地址，"可選標題"是鼠標懸停在鏈接上時出現(xiàn)的提示文字，可以省略。

示例：
[微信官網(wǎng)](https://weixin.qq.com/ "微信官網(wǎng)") → 微信官網(wǎng)^[1]

參考鏈接

當同一個鏈接在文章中出現(xiàn)多次時，使用這種方法可以方便統(tǒng)一管理。語法分為兩部分：

• ? 鏈接位置：在文中需要鏈接的地方寫 [鏈接文字][鏈接標識]。
• ? 鏈接定義：在文檔的任意位置（通常放在末尾）寫 [鏈接標識]: 真實的鏈接地址。

示例:

打開[微信公眾平臺][1]，可創(chuàng)建自己的公眾號。

[1]:https://mp.weixin.qq.com/

自動鏈接

用尖括號 < > 包裹網(wǎng)址或郵箱地址，Markdown 會自動將其轉換為可點擊的鏈接。

腳注鏈接

腳注鏈接用于在文章底部添加解釋或引用來源。語法分為兩部分：

• ? 添加注腳標記：在需要注釋的文字后面加上 [^注腳標識]。
• ? 定義注腳內容：在文檔末尾（或其他位置）寫 [^注腳標識]: 注腳的解釋內容。

示例：

使用 Markdown^[1]可以高效地寫作，利用微信公眾平臺^[2]可分享自己的文章。

1.HyperText Markup Language 超文本標記語言??
2.微信公眾平臺: https://mp.weixin.qq.com/??

使用 Markdown[^1] 可以高效地寫作，利用微信公眾平臺[^2]可分享自己的文章。

[^1]:HyperText Markup Language 超文本標記語言
[^2]:微信公眾平臺: https://mp.weixin.qq.com/

錨點鏈接

錨點鏈接用于在當前文檔內部進行跳轉，通常需要為標題定義一個標識符，然后用普通鏈接語法指向它。語法分兩個部分：

• ? 定義錨點：在標題后加上 {#自定義錨點名稱}，例如：## 章節(jié)標題 {#section1}。
• ? 鏈接到錨點：[跳轉到某一章](#section1)。

復雜樣式

Markdown 本身不支持復雜樣式，但可通過嵌入 HTML 標簽并結合 CSS 樣式實現(xiàn)個性化排版，核心是利用 HTML 的 style 屬性或 <style> 標簽定義樣式。

Markdown 已實現(xiàn)的文本樣式:

• ? 加粗文本：<strong> / <b>
• ? 傾斜文本：<em> / <i>
• ? 刪除線：<del>
• ? 分割線：<hr>
• ? 行內代碼：<code>
• ? 代碼塊：<pre>
• ? 行內引用：<q>
• ? 引用塊：<blockquote>

使用 HTML 標簽可實現(xiàn) Markdown 無法實現(xiàn)的文本樣式，例如：

• ? 上標：<sup>上標</sup>。X<sup>2</sup> → X²
• ? 下標：<sub>下標</sub>。Y<sub>2</sub> → Y₂
• ? 下劃線：<u>下劃線</u> 或 <ins>下劃線</ins> → 下劃線
• ? 高亮文本：<mark>高亮文本</mark> →高亮文本

使用 <div> 標簽下的 align 屬性可以設置文本對齊方式，文本對齊示例：

這段文本居左顯示

這段文本居中顯示

這段文本居右顯示

<div align="left">這段文本居左顯示</div>
<div align="center">這段文本居中顯示</div>
<div align="right">這段文本居右顯示</div>

使用 <font> 標簽下的 color 屬性可以設置文本顏色，face 屬性可以設置文本字體，size 屬性可以設置文本字號，文本顏色示例：
這是紅色文字
這是黃色文字
這是綠色文字
這是藍色文字

<font color="red">這是紅色文字</font>
<font color="yellow">這是黃色文字</font>
<font color="#00FF00">這是綠色文字</font>
<font color="#0000FF">這是藍色文字</font>

Markdown 寫作工具

Visual Studio Code

Visual Studio Code 簡稱 VS Code，是一款由微軟開發(fā)的免費、開源、跨平臺的代碼編輯器，兼具輕量、高效和高度可定制的特性。

1. 1. 下載
   訪問 VS Code 官網(wǎng)^[2] 下載對應操作系統(tǒng)（Windows, macOS, Linux）的安裝程序。
2. 2. 安裝
   運行安裝程序，按照引導進行安裝。
3. 3. 語言設置
   啟動 VS Code，使用快捷鍵 Ctrl+Shift+P 打開命令面板，輸入“Configure Display Language”或“Chinese”，安裝中文語言包并重啟。
4. 4. 插件安裝
   在擴展界面搜索并安裝對應插件。
• ? Markdown All in One 插件支持 Markdown 語法高亮、自動補全等，
• ? Markdown Preview Enhanced 插件提供強大的 Markdown 預覽功能，支持數(shù)學公式、圖表等，可導出 html、pdf 等多種格式。
5. 5. 創(chuàng)建項目
   在文件系統(tǒng)創(chuàng)建相應的項目文件夾，點擊 文件 → 打開文件夾，選擇創(chuàng)建的項目文件夾并打開。在項目文件夾下創(chuàng)建 .md 文件，并在文件中撰寫所需內容。
6. 6. 預覽
   在文件編輯界面右鍵單擊，選擇 MPE:打開側邊預覽 即可預覽 Markdown 內容。右鍵點擊側邊預覽窗口可以選擇 Preview Theme、Code Block Theme 和 Reveal.js Theme。
7. 7. 導出
• ? html 文件
  右鍵點擊側邊預覽窗口，選擇 Export → HTML → HTML (offline) 可導出 html 文件。
• ? pdf 文件
  右鍵點擊側邊預覽窗口，選擇 Export → Chrome (Puppeteer) → PDF 可導出 pdf 文件。如需顯示代碼塊背景，在 Markdown Preview Enhanced 插件設置選項里找到 Markdown-preview-enhanced: Print Background，勾選 Whether to print background for file export or not。
• ? 另存為 pdf 文件
  右鍵點擊側邊預覽窗口，選擇 Open in Browser，Ctrl+P 打印網(wǎng)頁，選擇 另存為PDF。通過勾選 背景圖形 可顯示代碼塊背景。布局、紙張大小、縮放、邊距、頁眉頁腳可自行設置。
8. 8. 樣式設置
    使用快捷鍵 Ctrl+Shift+P 打開命令面板，搜索 Markdown Preview Enhanced: Customize CSS ，帶 (Global) 后綴的是設置全局樣式，帶 (Workspace) 后綴的是設置工作區(qū)樣式。打開 Markdown Preview Enhanced: Customize CSS (Global)，通過填寫代碼可設置預覽和打印的樣式，如字體、字號、行距、背景顏色等。示例代碼如下：

html body {
  font-family: "思源宋體 CN Medium", "Times New Roman";
  font-size: 16px;
  font-weight: normal;
  line-height: 1.6;
  color: #000000;
  background-color: #ffffff;
  overflow: initial;
  box-sizing: border-box;
  word-wrap: break-word;
}

1. 9. 代碼自動換行
   設置代碼自動換行是為了避免導出 pdf 文件時部分代碼顯示不全。打開 Markdown Preview Enhanced: Customize CSS (Global)，填寫如下代碼即可實現(xiàn)代碼自動換行。

.markdown-preview.markdown-preview {
  
  // 自動換行：預覽用
  pre, code {
    white-space: pre-wrap;
    word-break: break-word;
    overflow: hidden;
  }

  // 自動換行：打印用
  @media print {
    pre, code {
      white-space: pre-wrap;
      word-break: break-word;
      overflow: hidden;
    }
  }
}

MarkText

MarkText 是一款專注于速度和可用性的開源 Markdown 編輯器，支持實時預覽模式，還提供了源碼模式、打字機模式和專注模式。

MarkText 可跨平臺使用，適用于 Windows、macOS 和 Linux 三大主流桌面操作系統(tǒng)?？稍?nbsp;MarkText GitHub 主頁^[3] 下載。

Doocs WeChat Markdown Editor

WeChat Markdown Editor 是一款專為微信公眾號文章排版設計的開源在線編輯器，可以使用 Markdown 語法寫作，然后一鍵生成樣式美觀、兼容微信公眾號后臺的圖文內容，避免了手動排版的繁瑣。支持 Markdown 語法、自定義主題樣式、代碼高亮、數(shù)學公式、Mermaid 圖表、多圖床等特性。

訪問 WeChat Markdown Editor 官網(wǎng)^[4]，可在線使用。訪問 doocs/md GitHub 主頁^[5] ，可了解源代碼自行部署。

引用鏈接

[1] 微信官網(wǎng): https://weixin.qq.com/
[2] VS Code 官網(wǎng): https://code.visualstudio.com/
[3] MarkText GitHub 主頁: https://github.com/marktext/marktext/
[4] WeChat Markdown Editor 官網(wǎng): https://md.doocs.org/
[5] doocs/md GitHub 主頁: https://github.com/doocs/md/