Markdown 基本用法


Posted by Torai on 2021-05-13

什麼是 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\. 避免數字轉成清單可加入反斜線
  1. Bird
  2. McHale
  3. Parish

1986. 避免數字轉成清單可加入反斜線


程式碼

行內程式碼用反引號 ` 包起來。區塊則使用連續三個,開始時可標註語言:

範例

console.log(i)

for (let i = 0; i < 10; i++) {
    console.log(i)
}

分隔線

連續三個 -


表格

thead1 thead2 thead3
td td td

斜體、粗體、連結、圖片

*斜體*
**粗體**
[連結文字](網址)
![圖片文字](網址)

斜體
粗體
連結文字
圖片文字

更詳細語法可看Markdown 文件

reference

wiki Markdown
Lidemy 上的 sixwings 同學分享
Markdown 文件


#Markdown







Related Posts

prop drilling 與 context

prop drilling 與 context

AI輔導室|馬賽克拼貼效果

AI輔導室|馬賽克拼貼效果

讀書筆記-版本控制使用Git: 檔案管理、索引、送交

讀書筆記-版本控制使用Git: 檔案管理、索引、送交


Comments