My Blog

Markdown 語法

發表於 更新於 分類於

Markdown簡介

根據Instant Markdown這本書作者提及，Markdown為一個輕量的markup語言，簡化了網頁作者的工作流程。有六個特性：

  1. 簡單使用（Easy to use）
  2. 快速（Fast）
  3. 簡潔（Clean）
  4. 彈性（Flexible）
  5. 可攜性（Portable）
  6. 專門為創作者而設計（Made for writers）

語法

一、段落

1
2
這是一段話，
然後分成兩行。

結果：
這是一段話，
然後分成兩行。
註：Markdown如果要換行的話，直接按Enter即可。

二、標題

1. Setext style
1
2
3
4
5
Header 1
========

Header 2
--------
2. Atx style
1
2
3
4
5
6
# Header 1
## Header 2
### Header 3
#### Header 4
##### Header 5
###### Header 6

註：此語法似html中Headings的h1至h6

二、文字樣式

種類 語法 成果 註
斜體 *斜斜的字* 斜斜的字 也可以使用_斜斜的字_
強調 **強調的字** 強調的字 也可以使用__強調的字__
強調+斜體 ***強調+斜體的字*** 強調+斜體的字 也可以使用___強調+斜體的字___
刪節線 ~~刪節線~~ 刪節線

三、加入文字連結

1
2
3
[這是Google Map的連結](https://www.google.com.tw/maps/)
[這是PChome的連結](https://24h.pchome.com.tw/index/)
[這是維基百科的連結](https://zh.wikipedia.org/zh-tw/Wikipedia:%E9%A6%96%E9%A1%B5)

結果：

這是Google Map的連結
這是PChome的連結
這是維基百科的連結

四、加入圖片連結

1
![這是一張曲流的照片](https://geography-revision.co.uk/wp-content/uploads/2020/02/Meanders.jpg)

結果：
這是一張曲流的照片

五、引用

1
2
3
4
5
6
7
>幾米：所有的悲傷，總會留下一絲歡樂的線索，
>所有的遺憾，總會留下一處完美的角落。
>我在冰封的深海，尋找希望的缺口，
>卻在午夜驚醒時，瞥見絕美的陽光。
>>內縮
>>>再內縮
>>>>繼續內縮

結果：

幾米：所有的悲傷，總會留下一絲歡樂的線索，
所有的遺憾，總會留下一處完美的角落。
我在冰封的深海，尋找希望的缺口，
卻在午夜驚醒時，瞥見絕美的陽光。

內縮

再內縮

繼續內縮

六、表列標號

1. 無排序表列標號
1
2
3
4
+ 第一行
+ 第二行
  + 第三行內縮
    + 第四行再內縮

結果：

  • 第一行
  • 第二行
    • 第三行內縮
      • 第四行再內縮

註：「+」可以「-」或「*」替代

2. 有排序表列標號
1
2
3
4
1. 第一行
2. 第二行
3. 第三行
4. 第四行

結果：

  1. 第一行
  2. 第二行
  3. 第三行
  4. 第四行

七、代辦事項

1
2
- [X] 已經完成
- [ ] 尚未完成

結果：

  • 已經完成
  • 尚未完成

八、表格

1
2
3
4
5
| 標題1 | 標題2 | 標題3 |
| -------- | -------- | -------- |
| 內容1 | 內容2 | 內容3 |
| 內容4 | 內容5 | 內容6 |

結果：

標題1 標題2 標題3
內容1 內容2 內容3
內容4 內容5 內容6

註：
:--- 為靠左對齊
---: 為靠右對齊
:---: 為至中對齊

九、各段落前空兩格?

Markdown似乎沒有該功能，故使用HTML語法。於各段落之前加入，例如：

1
  這是第一段的開頭，需要空兩格

結果：
  這是第一段的開頭，需要空兩格

十、HackMD

以Markdown語法為基礎的筆記網站，可以快速地達到筆記排版的功能。

由於是網路筆記，因此能夠即時地分享給其他人瀏覽或編輯，常用於團體討論與協作。該網站甚至也可以做成簡報模式，如下網址：
https://hackmd.io/yBgAAHfZQXyLUq2py_nTOA?both

整體而言，若需要快速記下筆記，又不喜歡word或google docs相對複雜的排版及列點方式，或者是欲探討一個議題，需要大家集思廣益而形成一個共識，以及筆記中需要紀錄大量程式碼時，該網站是個不錯的選擇！

Reference:

  1. Matt Cone (2020). The Markdown Guide. Independently Published.
  2. Arturo Herrero (2013). Instant Markdown. Packt Publishing.
  3. 撰寫 Hexo 文章 - Markdown 語法大全
  4. 實用！在HTML插入空白的6種方式