# Markdown 筆記

> 作者：王一哲
> 日期：2021/2/19

## 前言

Markdown 是一種輕量的標記語言，使用鍵盤上就有的標記做出具有數學式、清單、表格……等等的文件。我通常會使用 [HackMD](https://hackmd.io/) 線上編輯 Markdown 文件，單機版的部分則是使用 [Joplin](https://joplinapp.org/)、[Typora](https://typora.io/) 或是普通的純文字檔編輯器。網路上已經有許多 Markdown 語法的教學，以下是我常用的語法及筆記。
<br />

## 標題

標題共有6個層級，標題開頭以 \# 標示，有幾個 \# 就是第幾個層級的標題，通常一篇 Markdown 文件只會有一個第1層級的標題，語法及效果如下。

# 層級1
## 層級2
### 層級3
#### 層級4
##### 層級5
###### 層級6
###### tags:`標籤`

<br />

# 層級1
## 層級2
### 層級3
#### 層級4
##### 層級5
###### 層級6
###### tags:`標籤`

<br />

## 文字格式

Markdown 有以下的文字格式，如果使用的編輯軟體不支援上標、下標語法，可以改用 HTML 的語法。

*斜體*
**強調、粗體**
~~刪除線~~
^上標^ 或 <sup>上標</sup>
~下標~ 或 <sub>下標</sub>

<br />

*斜體*
**強調、粗體**
~~刪除線~~
^上標^
~下標~

<br />

## 數學式

Markdown 支援 $\LaTeX$ 語法，只要用 \$ 將 $\LaTeX$ 數學式區塊包起來即可，又分為獨立成段的單行數學式及行內數學式兩種格式。

$$
單行數學式 y = \frac{-b \pm \sqrt{b^2 - 4ac}}{2a}
$$

行內數學式 $y = \frac{-b \pm \sqrt{b^2 - 4ac}}{2a}$

<br />

$$
單行數學式 y = \frac{-b \pm \sqrt{b^2 - 4ac}}{2a}
$$

行內數學式 $y = \frac{-b \pm \sqrt{b^2 - 4ac}}{2a}$

<br />

## 程式碼

程式碼區塊以 \`\`\` 標示，開頭的 \`\`\` 後面可以加上程式碼的種類，例如c、python……等等，如果再加上 =，有些編輯器會自動為程式碼加上行號。以最簡單的 Hello World! 為例：

#include <stdio.h>

int main(void) {
    printf("Hello World!\n");
    return 0;
}

<br />

## 清單

清單分為無編號、有編號、待辦清單，以下是語法及效果。

- 項目1
- 項目2
- 項目3

1. 項目1
2. 項目2
3. 項目3

- [ ] 項目1（未完成）
- [ ] 項目2（未完成）
- [X] 項目3（已完成）

<br />

- 項目1
- 項目2
- 項目3

1. 項目1
2. 項目2
3. 項目3

- [ ] 項目1（未完成）
- [ ] 項目2（未完成）
- [X] 項目3（已完成）

<br />

## 表格

表格的語法及效果如下，空格及 - 的數量並不重要。

|   | column 1 | column 2 | column 3 |
|-|--|---|----|
| row 1 | a11 | a12 | a13 |
| row 2 | a21 | a22 | a23 |

<br />

| | column 1 | column 2 | column 3 |
|-|--|---|----|
| row 1 | a11 | a12 | a13 |
| row 2 | a21 | a22 | a23 |

<br />

## 超連結及圖片

超連結的語法為

[文字](網址)

以 [Google 首頁](https://www.google.com.tw/) 為例

[Google 首頁](https://www.google.com.tw/)

<br />

圖片的語法為

！[](網址或路徑 "說明文字（可不加）")

以我自己上傳到 Imgur 的照片為例，將滑鼠游標移到圖片上停住，游標處會顯示 D1 mini。

![](https://i.imgur.com/zf8SAST.jpg "D1 mini")

<br />

如果要做出用滑鼠左鍵點擊圖片、開啟 YouTube 影片的效果，可以使用以下的語法

[![](圖片連結)](影片連結)

以 DeltaMOOCx 高中物理的影片為例

[![](https://i.imgur.com/iPGnuzh.png)](https://youtu.be/Q59BINcFHOc)

[](https://youtu.be/Q59BINcFHOc)
<br />

## 引用區塊

引用區塊是以 \> 開頭，可以每一行都加上 \>，或是只有第一行都加上 \>，接下來在遇到空行之前的文字都在引用區塊的範圍內。如果引用區塊有很多層級，只要在該行開頭加上對應數量的 \> 即可。

> 引用區塊第1行
引用區塊第2行
引用區塊第3行

> 引用區塊第1層
>> 引用區塊第2層
>>> 引用區塊第3層

<br />

> 引用區塊第1行
>> 引用區塊第2行
>>> 引用區塊第3行

<br />

## 縮排

使用 tab 鍵縮排，可以有不同層級的縮排。

[tab]層級１
[tab][tab]層級２
[tab][tab][tab]層級３

層級１
層級２
層級３

<br />

## 分隔線

分隔線有以下幾種語法，看起來效果都一樣。

---
***
- - -
* * *

---
<br />

## 結語

以上是我常用的 Markdown 語法，網路上還有更多詳細的教學文章，有興趣的同學可以上網搜尋或是點擊下方的參考資料。
<br />

## 參考資料

1. [Markdown文件](https://markdown.tw/)
2. [MarkDown+HackMD新手教學](https://hackmd.io/@eMP9zQQ0Qt6I8Uqp2Vqy6w/SyiOheL5N/%2FzMIQV80gSiGGkKk1sa8HZA?type=book)

<br />

---

###### tags: `Markdown`