Markdown

了解如何使用markdown撰寫文件

tags: RD1

目錄

• Markdown
  • 列表
  • CheckBox
  • 表格
  • 區塊
  • 圖片
  • 連結
  • 階層式區塊
  • 粗體
  • 斜體
  • 刪除線
  • 分隔線
  • 跳脫字元
• 標題
  • 標題2
    • 標題3

GitHub

有使用過 GitHub 都一定有看過 README.md，而 md 表示的意思其實就是 Markdown ，所以如果在開發時會使用 README.md 的人，就一起來看看在 README.md 上如何用 Markdown 撰寫吧！

列表

寫法

- 這是清單
+ 這也是清單
* 這同樣是清單
- 清單子項目

顯示畫面

• 這是清單

• 這也是清單

• 這同樣是清單
  • 清單子項目

包含數字符號的列表則是使用 數字 + .作為開頭，列表中的第一個數字是數字列表的起始序號，而後方的數字不需要按照順序，如：1. 2. 2. 結果依然會是 1. 2. 3.；另外縮排的規則與一般列表相同

寫法

1. 數字型清單
2. 第二個數字清單
3. 數字清單不需要連續數字
   1. 數字清單子項目
   2. 數字清單子項目
   3. 數字清單子項目

顯示畫面

1. 數字型清單
2. 第二個數字清單
3. 數字清單不需要連續數字
   1. 數字清單子項目
   2. 數字清單子項目
   3. 數字清單子項目

CheckBox

寫法

- [ ] 待辦事項
- [x] 完成事項

顯示畫面

• 待辦事項
• 完成事項

表格

寫法

| thead 1 | thrad 2 | thread 3 |
|––––-|––––-|–––––|
| td | td | td |

顯示畫面

thead 1	thrad 2	thread 3
td	td	td

區塊

寫法

小區塊語法(前後加上`)：
`Format one word or one line`

高亮程式碼顯示語法 （前後三個反引號 ``` + 語言)

```sql
INSERT INTO 表 VALUES （值，值）
```

顯示畫面

小區塊語法(前後加上`)：
Format one word or one line

大區塊語法(四個空白)：

​​​​code (4 spaces indent)

高亮程式碼顯示語法 （前後三個反引號 ``` + 語言)

INSERT INTO 表 VALUES （值，值）

圖片

寫法


一個驚嘆號!
接著一個方括號，裡面放上圖片的替代文字
接著一個普通括號，裡面放上圖片的網址，最後還可以用引號包住並加上 選擇性的’title’文字。

ex:


顯示畫面

連結

寫法

[名稱](連結)

ex:
[Markdown文件](https://markdown.tw/)

顯示畫面

Markdown文件

階層式區塊

階層式區塊在表現結構或功能關係上是相當好用的呈現形式

階層式區塊語法：

> Quote one sentences
>>Quote two sentences
>>Quote two sentences
>>>Quote three sentences

顯示結果：

Quote one sentences

Quote two sentences
Quote two sentences

Quote three sentences

粗體

寫法

**bold**
__bold__

顯示結果：

bold
bold

斜體

寫法

*bold*
_bold_

顯示結果：

bold
bold

刪除線

寫法

~~我是刪除線~~

顯示結果：

我是刪除線

分隔線

寫法

分隔線，可以使用三個連續符號表示（-、*，部分環境亦可使用 _）

-– (三個減號)
*** (三個星號)
___ (三個底線)

顯示結果：

---

---

---

跳脫字元

Markdown可以利用反斜線來插入一些在語法中有其他意義的符號，例如：如果你想要用星號加在文字旁邊的方式來做出強調效果（但不用標籤），你可以在星號的前面加上反斜線：

Markdown支援在下面這些符號前面加上反斜線來幫助插入普通的符號：

\ 反斜線
` 反引號
_ 底線
{} 大括號
[] 方括號
() 括號
# 井字號
+ 加號
- 減號
. 英文句點
! 驚嘆號
* 星號

標題

# 標題1

標題2

## 標題2

標題3

### 標題3

標題4

#### 標題4

標題5

##### 標題5

標題6

###### 標題6

參考資料

Markdown文件
Markdown - 易編易讀，優雅的寫文吧！
十分鐘快速掌握 Markdown