Markdown
文件標記語言簡介

https://hackmd.io/@ntouind/markdown-basics

海洋大學網路發展協會
http://ind.ntou.edu.tw

這是一個基於 Markdown 的 HackMD 簡報
點此查看本簡報的來源碼

本作品以
《Creative Commons 姓名標示-相同方式分享》
授權條款 4.0 國際版釋出
供大眾於授權範圍內自由使用本作品

Markdown 的特色
Markdown Features

• 源碼可讀性高（靈感來自純文字的電子郵件格式）
• 可直接轉換為 HTML 網頁，可混用 HTML 標記
• 內容與格式化分離，要美化可套用 CSS
• 第三方功能擴充性高（視 Markdown 應用支援）

支援 Markdown 的編輯器
族繁不及備載

Web 應用

• HackMD
• Stackedit

本地端應用

• Typora

標題
Headings

ATX 風格標題標記

# 第一階標題
## 第二階標題
...
###### 第六階標題（行尾的井號僅有美觀效果不會出現在轉換結果中） ######

第一階標題

第二階標題

第六階標題（行尾的井號僅有美觀效果不會出現在轉換結果中）

Setext 風格標題標記

第一階標題
===

第二階標題
---

此風格僅支援這兩個階級的標題

第一階標題

第二階標題

此風格僅支援這兩種標題

一般文字
Regular text

不需要任何語法，直接輸入即可

不需要任何語法，直接輸入即可

換行
Line breaks

行尾加上兩空白字元就能換行

第一行[][]   
第二行

第一行
第二行

段落
Paragraphs

這是第一段的內容。

間隔一空行的內容會自動呈現為第二段。

第三段，留意段落之間的留白並非為空行所構成。

這是第一段的內容。

間隔一空行的內容會自動呈現為第二段。

第三段，留意段落之間的留白並非為空行所構成。

超連結
Hyperlinks

[Google 搜尋引擎](https://google.com)

<https://google.com>

Google 搜尋引擎

https://google.com

插入圖片
Image insertion

![Reddit r/place畫布中的Taiwan No.1](https://i.imgur.com/fefdJO5.png "Taiwan No.1")

![圖片失效時會顯示其替代文字](https://i.imgur.com:65536/fefdJO5.png)

清單
Lists

• 購物清單
• 待辦事項清單(todo list)
• 資產清單

無序(無順序性的)清單
Unordered list

* 就像這樣
    + 子清單項目
    + 星號、減號、加號都可以當作清單項目符號（不影響呈現式樣）
        - Markdown 主要使用 4 個空格或 1 個換欄號(Tab)作為縮排使用

• 就像這樣
  • 子清單項目
  • 星號、減號、加號都可以當作清單項目符號（不影響呈現式樣）
    • Markdown 主要使用 4 個空格或 1 個換欄號(Tab)作為縮排使用

有序(有順序性的)清單
Ordered list

1. 就像這樣
1. 呈現出來的編號永遠用自然數遞增，不隨源碼使用的編號數字影響
    * 子清單可混用無序清單
        1. 反之亦可
5. 同第 2 項

1. 就像這樣
2. 呈現出來的編號永遠用自然數遞增，不隨源碼使用的編號數字影響
   • 子清單可混用無序清單
     1. 反之亦可
3. 同第 2 項

清單與非清單內容間須額外留一空行

這是等一下要採購的東西：

* 蘋果
* 香蕉
* 芭樂

記得要拿發票

這是等一下要採購的東西：

• 蘋果
• 香蕉
• 芭樂

記得要拿發票

區塊引言
Blockquotes

> > 奇藍藍奇CP可逆不可拆
> > 
> 我覺得不行
> 
我覺得可以

奇藍藍奇CP可逆不可拆

我覺得不行

我覺得可以

預格式化文字
Pre-formatted text

```
#include <stdio.h>
#include <stdlib.h>

int main(int argc, char * argv[]){
    printf("Hello world!\n");
    return EXIT_SUCCESS;
}
```

#include <stdio.h>
#include <stdlib.h>

int main(int argc, char * argv[]){
    printf("Hello world!\n");
    return EXIT_SUCCESS;
}

水平線
Horizontal line

---

就會呈現為一水平線↑

強調
Emphasis

**這段文字呈現為粗體**

*這段文字呈現為斜體*

***這段文字呈現為粗斜體***

這段文字呈現為粗體

這段文字呈現為斜體

這段文字呈現為粗斜體

第三方擴充語法
Third-party syntax extensions

這些語法並非在 Markdown 標記語言中，是否支援視各應用實作而定

刪除線
Strikethrough text
GitHub Flavored Markdown 擴充語法

在套用的內容兩側加上兩個波浪號即可套用~~刪除線~~

在套用的內容兩側加上兩個波浪號即可套用刪除線

插入表格
Table insertion
GitHub Flavored Markdown 擴充語法

| 表頭1 | 表頭2 |
| --- | --- |
| 第1列第1欄的值 | 第1列第2欄的值 |
| 第2列第1欄的值 | 第2列第2欄的值 |

插入表格
Table insertion
GitHub Flavored Markdown 擴充語法

| 表頭1 | 表頭2 |
| :-: | :-: |
| 第1列第1欄的值 | 第1列第2欄的值 |
| 第2列第1欄的值 | 第2列第2欄的值 |

插入表格
Table insertion
GitHub Flavored Markdown 擴充語法

| 表頭1 | 表頭2 |
| --: | --: |
| 第1列第1欄的值 | 第1列第2欄的值 |
| 第2列第1欄的值 | 第2列第2欄的值 |

插入表格
Table insertion
GitHub Flavored Markdown 擴充語法

| 表頭1 | 表頭2 |
| :-- | :-- |
| 第1列第1欄的值 | 第1列第2欄的值 |
| 第2列第1欄的值 | 第2列第2欄的值 |

工作清單
Task list
GitHub Flavored Markdown 擴充語法

* [ ] 吃飯
* [ ] 睡覺
* [x] 打東東

• 吃飯
• 睡覺
• 打東東

LaTeX 數學 / 科學公式輸入
部份 Markdown 應用支援

$$ 
    F_e = \frac{1}{4 \pi \epsilon_0} \frac{q_1 q_2}{r^2}
$$

答案是 $3X$

\[ F_e = \frac{1}{4 \pi \epsilon_0} \frac{q_1 q_2}{r^2} \]

程式碼語法色彩突顯
Syntax highlighting

```c
#include <stdio.h>
#include <stdlib.h>

int main(int argc, char * argv[]){
    printf("Hello world!\n");
    return EXIT_SUCCESS;
}
```

#include <stdio.h>
#include <stdlib.h>

int main(int argc, char * argv[]){
    printf("Hello world!\n");
    return EXIT_SUCCESS;
}

參考資料
References

• Daring Fireball: Markdown Syntax Documentation
  Markdown 發明者的說明文件
• Markdown 語法說明
  Markdown 說明文件的非官方台灣中文翻譯
• CommonMark - A strongly defined, highly compatible specification of Markdown
  定義更精確的第三方Markdown規範