什麼是 Markdown
這是 wiki 上的說明:
Markdown是一種輕量級標記式語言(Lightweight Markup Language),創始人為約翰·格魯伯。它允許人們使用易讀易寫的純文字格式編寫文件,然後轉換成有效的XHTML(或者HTML)文件。
剛開始可能頭昏眼花,明明只是想要了解 Markdown 是什麼,卻遇到更多不熟悉的名詞來解釋它。
接下來用白話一點的方式來說明。
平常寫作文、編輯 word 所使用的文字,是純文字。而如果在文章中想要「強調」或是某些片段,我們會使用引號把它們標記起來。這就是標記式語言的概念,如果我們想要它是粗體,就用特定的結構(此例為 **文字**
)把它包起來,告訴程式遇到這兩個字時要顯示成粗體。使用 markdown 語法所寫成的文件會以 .md
做副檔名。
markdown 因為其輕量的特性,容易被閱讀與寫作,適合作為網路內容的寫作用語言。現在這篇文章就是依 markdown 語法所寫的。在其它許多服務上都能使用,如 LINE、Telegram、Facebook、plurk、Coderbridge、notion、HackMD 等等,各服務支援度不同要自己嘗試看看。
之所以稱為輕量級,是因為 Markdown 相對於其他標記式語言(markup language,如 HTML、XML)的語法,更貼近我們平常所使用的自然語言,更好被人讀懂的關係。
實作上使用套件將 Markdown 轉換成 HTML,再由排版引擎轉換成人眼所見的頁面。由於缺乏明確的規範,這個轉換的結果依照平台所使用的套件有些微的差異。可能同樣一份 .md
文件,會多一個換行或者縮排之類的。
語法
標題
在文字前面加上 1~6 個 #
,數量越少重要程度越高。
# 標題1
## 標題2
...
###### 標題6
會變成這樣
標題1
標題2
...
標題6
文字段落
沒有任何標記則是文字段落,段落之間應保留一行空行。
若是想要插入 <br>
標籤(HTML 裡的換行),可在行尾加入兩個以上的空白,然後按 enter。
第一段文字。
第二段文字段落。
第一段文字。
第二段文字段落。
引言
在每行最前面加上 >
:
> This is a blockquote with two paragraphs. Lorem ipsum dolor sit amet,
> consectetuer adipiscing elit. Aliquam hendrerit mi posuere lectus.
> Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, risus.
This is a blockquote with two paragraphs. Lorem ipsum dolor sit amet,
consectetuer adipiscing elit. Aliquam hendrerit mi posuere lectus.
Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, risus.
清單
無序清單可使用 *
、+
、-
作為標記:
* Red
* Green
* Blue
- Red
- Green
- Blue
有序清單使用數字加上一個英文句點,書寫時數字的正確性不影響顯示,但還是建議按照順序:
1. Bird
2. McHale
3. Parish
1986\. 避免數字轉成清單可加入反斜線
- Bird
- McHale
- Parish
1986. 避免數字轉成清單可加入反斜線
程式碼
行內程式碼用反引號 ` 包起來。區塊則使用連續三個,開始時可標註語言:
console.log(i)
for (let i = 0; i < 10; i++) {
console.log(i)
}
分隔線
連續三個 -
。
表格
thead1 | thead2 | thead3 |
---|---|---|
td | td | td |
斜體、粗體、連結、圖片
*斜體*
**粗體**
[連結文字](網址)
![圖片文字](網址)
斜體
粗體
連結文字
更詳細語法可看Markdown 文件