Markdown 示例 - 如何快速入门 Markdown#
這是一篇示例文章,測試 Markdown 展示效果。
一、.Markdown 標題#
Markdown 支持兩種標題的語法:Setext 形式和 Atx 形式
1. Setext 形式#
Setext 形式是用底線的形式,利用 = (最高階標題)和 - (第二階標題)
例如:
2. Atx 形式#
Atx 形式在行首插入 1 到 6 個 # ,對應到標題 1 到 6 階。
例如:
# 一級標題
## 二級標題
### 三級標題
#### 四級標題
##### 五級標題
###### 六級標題
標題的使用在 Markdown 使用中非常頻繁,一般以自己使用習慣來就行,不過大部分軟體都支持第二種 #
類型的標題樣式,第一種平常用的偏少。
二、區塊引用#
區塊引用則使用 email 形式的 '>' 角括號。
例如:
> 引用
>
> > 引用中的引用
>
> ## 引用中的標題
引用
引用中的引用
引用中的標題#
Markdown 使用星號和底線來標記需要強調的區段。單標記表示斜體,雙標記表示粗體
例如:
使用單星號: *星號斜體*
使用單下劃線: _下劃線斜體_
使用雙星號: **星號粗體**
使用雙下劃線: __下劃線粗體__
刪除線:~~刪除線~~
- 使用單星號: 星號斜體
- 使用單下劃線: 下劃線斜體
- 使用雙星號: 星號粗體
- 使用雙下劃線: 下劃線粗體
- 刪除線:
刪除線
三、無序列表#
無序列表:使用星號(*)、加號(+)和減號(-)來做為列表的項目標記
星號、加號、減號:
* Candy.
+ Gum.
- Booze.
- Candy.
- Gum.
- Booze.
四、有序列表#
有序列表:使用一般的數字接著一英文句點作為項目標記,數字不能省略但可無序,點號之後的空格不能少
1. Red
2. Green
3. Blue
- Red
- Green
- Blue
五、嵌套列表:#
-
、+
、*
可循環使用,但符號之後的空格不能少,符號之前的空格也不能少
- 嵌套列表1
+ 嵌套列表1a
+ 嵌套列表1b
- 嵌套列表1ai
* 嵌套列表1aix
- 嵌套列表2
- 嵌套列表 1
- 嵌套列表 1a
- 嵌套列表 1ai
- 嵌套列表 1aix
- 嵌套列表 1ai
- 嵌套列表 1b
- 嵌套列表 1a
- 嵌套列表 2
三個或更多 -_*,必須單獨一行,可含空格(注意如果在文字後使用 ---,則為副標題)
此外有序列表和無序列表有多級的話也可以通過
Tab
和Shift
+Tab
縮進實現。
六、插入鏈接#
在 Markdown 中,插入鏈接不需要其他按鈕,你只需要使用[顯示文本](鏈接地址)
這樣的語法即可,例如:
文字超鏈:[GitHub](http://www.github.com)
索引超鏈:
[Google][1] [1]:http://www.google.com
自動鏈接:http://www.google.com
郵箱鏈接:<[email protected]>
文字超鏈: GitHub
索引超鏈: Google
郵箱鏈接:[email protected]
七、圖片超鏈#
在 Markdown 中,插入圖片不需要其他按鈕,你只需要使用 ![image](https://xxx.jpg]
這樣的語法即可,例如:
![congjinyebaiya](https://cdn.hashnode.com/res/hashnode/image/upload/v1650872248441/srP9RSsrv.png)
注:插入圖片的語法和鏈接的語法很像,只是前面多了一個 !。*
八、代碼塊#
`字符`(簡短文字添加代碼框)
`Tab`或四個空格(大段文字添加代碼框,每行前添加)
字符
Tab或四個空格
九、大段代碼塊#
在你的代碼塊的前面和後面都加上三個反引號 ` 即可,在第一行後指定編程語言,也可以不指定
@requires_authorization
def somefunc(param1='', param2=0):
'''A docstring'''
if param1 > param2: # interesting
print 'Greater'
return (param2 - param1 + 1) or None
class SomeClass:
pass
>>> message = '''interpreter
... prompt'''
十、特殊符號#
特殊符號前可以加反斜線表示轉義
\\ 反斜杠
\` 反引號
\* 星號
\_ 下劃線
\{\} 大括號
\[\] 中括號
\(\) 小括號
\+ 加號
\- 減號
\. 英文句號
\! 感嘆號
- \ 反斜杠
- ` 反引號
- * 星號
- _ 下劃線
- {} 大括號
- [] 中括號
- () 小括號
- + 加號
- - 減號
- . 英文句號
- ! 感嘆號
十一、表格#
- 使用 | 來分隔不同的單元格,使用 - 來分隔表頭和其他行:
name | age 區分單元格
---- | --- 分隔表頭和其他行
LearnShare | 12
Mike | 32
name | age |
---|---|
LearnShare | 12 |
Mike | 32 |
- 為了美觀,可以使用空格對齊不同行的單元格,並在左右兩側都使用來標記單元格邊界:
| name | age |
| ---------- | --- |
| LearnShare | 12 |
| Mike | 32 |
name | age |
---|---|
LearnShare | 12 |
Mike | 32 |
- 在表頭下方的分隔線標記中加入 :,即可標記下方單元格內容的對齊方式:
| left | center | right |
| :--- | :----: | ----: |
| aaaa | bbbbbb | ccccc |
| a | b | c |
left | center | right |
---|---|---|
aaaa | bbbbbb | ccccc |
a | b | c |
十二、分隔線#
---