1. 標題
總共分為六個層級,依據 HTML 的結構會轉為 <h1> ~ <h6>
,形式上是在文字前方補上不同數量的 #
,#
數量越少層級越高,反之則是越低,以下方結構來說 # 標題 1
是層級最高,且視覺上最大的標題
1 | # 標題1 |
標題1
標題2
標題3
標題4
標題5
標題6
2. 文字段落
1 | 不加任何標示符號時,就會被認為是**文字段落區塊**。 |
不加任何標示符號時,就會被認為是文字段落區塊。
3. 引用
只要在文章前面加上 大於 的符號即可。
1 | > 這裡是一段引用文字 |
這裡是一段引用文字
4. 清單
清單分為一般列表及包含數字符號的列表,兩種都包含多個層級,只要加上一個縮排或兩個空格就可以新增一個層級。
一般列表的使用彈性較高,-
、+
、*
等符號後方加上一個空白後都可以轉為列表,要表示下一個層級可多一個縮排或是兩個空白即可。
1 | - 這是清單 |
- 這是清單
- 這也是清單
- 這同樣是清單
- 清單子項目
包含數字符號的列表則是使用 數字 + .
作為開頭,列表中的第一個數字是數字列表的起始序號,而後方的數字不需要按照順序,如:1. 2. 2.
結果依然會是 1. 2. 3.
;另外縮排的規則與一般列表相同。
1 | 1. 數字型清單 |
數字型清單
第二個數字清單
數字清單不需要連續數字
- 數字清單子項目
如果段落文字需要以數字 + .
作為開頭,可以改為 數字 + 反斜線 + .,範例如下。
1 | 2019\. 避免 `數字.` 轉為數字型清單的方法 |
2019. 避免 數字.
轉為數字型清單的方法
5. 區塊程式碼
作為許多工程師的文本工具,常常會需要插入程式碼。
要插入的程式語言前後加上三個反引號,**『程式語言』*
* (esc鍵下面)可生成相應的程式碼區塊。
1 | 1. ```java```//生成java代碼區塊 |
在區塊內輸入或貼上程式碼
for (let i = 0; i < 10; i++) {
setTimeout(function () {
console.log(‘這執行第’ + i + ‘次’);
}, 0);
}
1 | for (let i = 0; i < 10; i++) { |
6.分隔線
分隔線,可以使用三個連續符號表示(-
、*
,部分環境亦可使用 _
)
1 | --- |
7. 表格
雖然 Markdown 有提供表格的符號,但實際運用上並不是很方便,所以我會使用軟體編輯器(例如:Typora) 內建的功能快速生成。Markdown 的表個就像是使用符號 “畫” 一個表格,實際撰寫時對其很麻煩。
1 | | thead 1 | thrad 2 | thread 3 | |
thead 1 | thrad 2 | thread 3 |
---|---|---|
td | td | td |
8.行內文本元素
套用此類別的內容可插入於區塊內,如:強調文字、斜體字、文字連結等等,要特別注意插入圖片也是屬於此類別(與 HTML 特性相符合)。
斜體
斜體字可以使用 *
或 _
符號套用在文字的前後方,即可將文字改為斜體字。
以下為斜體文字的範例,另外在 *
或 _
的前後補上空白會維持原本的符號,就不會套用斜體效果。
1 | *輸入文字* |
輸入文字
輸入文字
_ 輸入文字 _
強調
強調文字可以使用 **
或 __
符號套用在文字的前後方,即可強調文字。
一樣在 **
或 __
的前後補上空白會維持原本的符號
1 | **強調文字** |
強調文字
強調文字
__ 強調文字 __
小區塊
使用單個反引號==`==放在前後。
1 | Markdown是一種`輕量級標記式語言` |
Markdown是一種輕量級標記式語言
9. 連結
鏈結需要在網頁上才會實現超連結的功能,不然只會出現網址提示。
連結的結構略有不同,會分為前後兩個片段符號:
- 前者為
[ ]
:中括號內需要補上連結的顯示文字。 - 後者為
( )
:小括號內補上的是連結路徑。
1 | [Google](https://www.google.com.tw/) |
10.圖片
圖片也可以放在文字段落之中(與 HTML 中的 img 標籤邏輯一致),不過大多情況下會將圖片作為獨立區塊使用,
圖片也與連結結構接近,只不過前方多了 !
:
![ ]
:與連結結構接近,但前方緊貼著!
符號。中括號的內容也並非必填,其文字內容通常作為 hover 後的提示文字或作為 SEO 增強使用。( )
:圖片連結位置。
1 | ![Mackdown](https://www.google.com/url?sa=i&url=https%3A%2F%2Fen.wikipedia.org%2Fwiki%2FMarkdown&psig=AOvVaw21zAQL_wZFOXZ5Qq_tTAqI&ust=1607069540698000&source=images&cd=vfe&ved=0CAIQjRxqFwoTCJiOgduuse0CFQAAAAAdAAAAABAD) |