Markdown語法圖文全面詳解
目錄
簡介:
md格式是近幾年流行起的一個純文本格式,對於一個程序員來說,用md格式代替word、txt等格式用來寫說明文檔或者blog,目前github以及CSDN都支持md格式書寫blog了,用着用着就開始喜歡上了。
本篇文章主要就是記錄一下md格式的語法,md語法在幾乎所有支持md格式的軟件都是通用的,而快捷鍵是在MarkdownPad2軟件環境下。
文章目錄
1、Markdown常用快捷鍵
功能 | 快捷鍵 |
---|---|
標題 | ctrl+1 用#號表示,#一級標題,##表示二級標題,依次類推,快捷鍵ctrl+1、2、3、4… |
加粗 | 左右用**包裹起來,快捷鍵 Ctrl + B |
斜體 | 左右用*包裹起來,快捷鍵Ctrl + I |
引用 | 在文字開頭添加 > 表示引用說明,快捷鍵 Ctrl + Q |
插入鏈接 | 快捷鍵 Ctrl + L |
插入代碼 | 可以通過tab或者4個空格縮進表示,也可以通過“`將代碼包裹起來表示代碼塊,快捷鍵 Ctrl + K |
插入圖片 | 快捷鍵 Ctrl + G |
提升標題 | Ctrl + H |
有序列表 | 通過-加一個空格表示,後面跟內容,快捷鍵 Ctrl + U |
無序列表 | 通過數字加一個.以及一個空格表示,後面跟內容,快捷鍵ctrl+shift+o |
橫線 | 快捷鍵 Ctrl + R |
撤銷 | 快捷鍵 Ctrl + Z |
重做 | 快捷鍵 Ctrl + Y |
時間戳 | 快捷鍵 Ctrl + T |
加粗加斜體 | 左右用***包裹起來,快捷鍵ctrl+i,ctrl+b,先後順序無所謂 |
生成目錄 | [TOC]按回車 |
2、基本語法
2.1 字體設置斜體、粗體、刪除線
這裏顯示正文
*這裏顯示的是斜體*
_這裏顯示的傾斜體_
**這裏顯示的文字是加粗了**
***這裏的文字是傾斜加粗的***
~~這裏的文字是加下劃線的~~
顯示如下
這裏顯示正文
這裏顯示的是斜體
這裏顯示的傾斜體
這裏顯示的文字是加粗了
這裏的文字是傾斜加粗的
這裏的文字是加下劃線的
2.2 分級標題
寫發1:
Markdown 支持兩種標題的語法,類 Setext 和類 atx 形式。
類 Atx 形式則是在行首插入 1 到 6 個 # ,對應到標題 1 到 6 階,例如:
# 一級標題
## 二級標題
### 三級標題
#### 四級標題
##### 五級標題
###### 六級標題
這個寫法和 **文字**效果是一樣的
輸出的結果:
一級標題
二級標題
三級標題
四級標題
五級標題
六級標題
寫法2:
Markdown 支持兩種標題的語法,類 Setext 和類 atx 形式。
類 Setext 形式是用底線的形式,利用 = (最高階標題)和 - (第二階標題),任何數量的 = 和 - 都可以有效果。例如:
這是一個一級標題
============================
輸出結果:
這是一個一級標題
或者
二級標題
-----------
輸出結果:
二級標題
2.3 鏈接
(1)插入本地圖片鏈接的方法有兩種:
![圖片描述](圖片路徑"title")
![圖片描述](圖片路徑)
注:圖片描述可以不寫。
如本地插入圖片示範:
![插入下一層級目錄下的圖片](/短視頻封面/083.jpg)
![插入同級目錄下的圖片](/原創扁平方盒-逐浪字體.jpg)
效果:
[外鏈圖片轉存失敗,源站可能有防盜鏈機制,建議將圖片保存下來直接上傳(img-9ZByEYWc-1590402296624)(/短視頻封面/083.jpg)]
[外鏈圖片轉存失敗,源站可能有防盜鏈機制,建議將圖片保存下來直接上傳(img-JZWwx0JZ-1590402296627)(/原創扁平方盒-逐浪字體.jpg)]
(2)插入互聯網上圖片
![圖片描述](圖片網絡路徑)
注:圖片描述與插入本地圖片一樣,描述可以不寫。
寫法:
![圖片描述](https://www.z01.com/template/office/style/images/hezi5.jpg)
效果:
[外鏈圖片轉存失敗,源站可能有防盜鏈機制,建議將圖片保存下來直接上傳(img-wsw5q3aP-1590402296628)(https://www.z01.com/template/office/style/images/hezi5.jpg)]
(3)自動連接
Markdown 支持以比較簡短的自動鏈接形式來處理網址和電子郵件信箱,只要是用<>包起來, Markdown 就會自動把它轉成鏈接。也可以直接寫,也是可以顯示成鏈接形式的。
鏈接內容定義的形式爲:
方括號(前面可以選擇性地加上至多三個空格來縮進),裏面輸入鏈接文字
接着一個冒號
接着一個以上的空格或製表符
接着鏈接的網址
選擇性地接着 title 內容,可以用單引號、雙引號或是括弧包着
下面這三種鏈接的定義都是相同:
[這是一個鏈接]: http://www.z01.com/ "這裏是鏈接的title內容"
[這是一個鏈接]: http://www.z01.com/ '這裏是鏈接的title內容'
[這是一個鏈接]: http://www.z01.com/ (這裏是鏈接的title內容)
這是一個鏈接 [這是逐浪軟件官網鏈接](http://www.z01.com/).
結果:
這是一個鏈接 這是逐浪軟件官網鏈接.
在鏈接的時候也可以選擇加上title屬性,title 屬性是選擇性的,鏈接名稱可以用字母、數字和空格,但是不分大小寫:
這是一個鏈接 [這是逐浪軟件官網鏈接](http://www.z01.com/ "歡迎訪問逐浪軟件官網").
結果:
這是一個鏈接 這是逐浪軟件官網鏈接
輸出 HTML 爲:
<p>這是一個鏈接 <a href="http://www.z01.com/" title="歡迎訪問逐浪軟件官網">
這是逐浪軟件官網鏈接</a>.</p>
2.4 代碼塊
對於程序員來說代碼功能是必不可少的,插入程序代碼的方式有兩種,一種是利用縮進(tab), 另一種是利用英文“`”符號(一般在ESC鍵下方,和~同一個鍵)包裹代碼。
如果要標記一小段行內代碼,你可以用反引號把它包起來(```),例如:
Use the `printf()` function.
會產生:
<p>Use the <code>printf()</code> function.</p>
如果要在代碼區段內插入反引號,你可以用多個反引號來開啓和結束代碼區段:
There is a literal backtick (`) here.
這段語法會產生:
There is a literal backtick (`) here.
在代碼區塊裏面, & 、 < 和 > 會自動轉成 HTML 實體,這樣的方式讓你非常容易使用 Markdown 插入範例用的 HTML 原始碼,只需要複製貼上,剩下的 Markdown 都會幫你處理,Markdown會把下面這段:
`Please don't use any `<blink>` tags.
轉爲:
<p>Please don't use any <code><blink></code> tags.</p>
你也可以這樣寫:
—` is the decimal-encoded equivalent of `—`.
以產生:
`Please don't use any `<blink>` tags.
<p><code>&#8212;</code> is the decimal-encoded
equivalent of <code>&mdash;</code>.</p>
2.5 分割線
你可以在一行中用三個以上的星號、減號、底線來建立一個分隔線,行內不能有其他東西。你也可以在星號或是減號中間插入空格。下面每種寫法都可以建立分隔線:
* * *
***
*****
- - -
---------------------------------------
2.6 強調
Markdown 使用星號()和底線(_)作爲標記強調字詞的符號,被 * 或 _ 包圍的字詞會被轉成用 標籤包圍,用兩個或_包起來的話,則會被轉成,例如:
*single asterisks*
_single underscores_
**double asterisks**
__double underscores__
會轉成:
<em>single asterisks</em>
<em>single underscores</em>
<strong>double asterisks</strong>
<strong>double underscores</strong>
你可以隨便用你喜歡的樣式,唯一的限制是,你用什麼符號開啓標籤,就要用什麼符號結束。
強調也可以直接插在文字中間:
un*frigging*believable
但是如果你的 * 和 _ 兩邊都有空白的話,它們就只會被當成普通的符號。
如果要在文字前後直接插入普通的星號或底線,你可以用反斜線:
\*this text is surrounded by literal asterisks\*
2.7 引用
在被引用的文本前加上>符號,以及一個空格就可以了,如果只輸入了一個>符號會產生一個空白的引用。
(1)基本使用
使用如下圖所示:
> 文字引用
> 文字引用
> 文字引用
> 文字引用
> 文字引用
>
> 文字引用
> 文字引用
> 文字引用
顯示如下:
文字引用
文字引用
文字引用
文字引用
文字引用文字引用
文字引用
文字引用
(2)嵌套引用
>>>第一層嵌套引用
>>第二層嵌套引用
>第三層嵌套引用
顯示如下:
第一層嵌套引用
第二層嵌套引用
第三層嵌套引用
(3)引用其它要素
引用的區塊內也可以使用其他的 Markdown 語法,包括標題、列表、代碼區塊等。
使用如圖所示:
2.8 列表
Markdown 支持有序列表和無序列表。
無序列表使用星號、加號或是減號作爲列表標記:
不管是無序列表還是有序列表,符號後面一定要有一個空格,起到縮進的作用。
(1)無序列表
使用 星號*,加號+,減號- 表示無序列表。
* 無序列表文字
* 無序列表文字
* 無序列表文字
等同於:
+ 無序列表文字
+ 無序列表文字
+ 無序列表文字
也等同於:
- 無序列表文字
- 無序列表文字
- 無序列表文字
最後顯示結果相同,顯示如下:
- 無序列表文字–前是*號的顯示
- 無序列表文字–前是*號的顯示
- 無序列表文字–前是*號的顯示
- 無序列表文字–前是+號的顯示
- 無序列表文字–前是+號的顯示
- 無序列表文字–前是+號的顯示
- 無序列表文字–前是-號的顯示
- 無序列表文字–前是-號的顯示
- 無序列表文字–前是-號的顯示
(2)有序列表
有序列表則使用數字接着一個英文句點:
注意:英文句點後面一定要有一個空格,起到縮進的作用。
1. 有序列表
2. 有序列表
3. 有序列表
顯示結果如下:
- 有序列表
- 有序列表
- 有序列表
(3)無序列表和有序列表同時使用
* 這是無序列表1
- 這是無序列表2
+ 這是無序列表3
1. 這是有序列表1
2. 這是有序列表2
* 1. 有序無序混合使用1
+ 2. 有序無序混合使用2
- 這是無序列表1
- 這是無序列表2
- 這是無序列表3
- 這是有序列表1
- 這是有序列表2
-
- 有序無序混合使用1
-
- 有序無序混合使用2
(4)注意事項
在使用列表時,只要是數字後面加上英文的點,就會無意間產生列表,比如2020.5.25 這時候想表達的是日期,有些軟件把它被誤認爲是列表。解決方式:在每個點前面加上\就可以了。如下圖所示:
2020\. 05\. 25. 今天是2020年5月25日
顯示如下:
2020. 05. 25. 今天是2020年5月25日
2.9 表格
(1)極簡模式
水果名稱| 價格 | 數量
-|-|-
香蕉 | $1 | 5 |
蘋果 | $1 | 6 |
草莓 | $1 | 7 |
效果如下:
水果名稱 | 價格 | 數量 |
---|---|---|
香蕉 | $1 | 5 |
蘋果 | $1 | 6 |
草莓 | $1 | 7 |
(2)簡單方法
name | 111 | 222 | 333 | 444
- | :-: | :-: | :-: | -:
aaa | bbb | ccc | ddd | eee|
fff | ggg| hhh | iii | 000|
效果如下:
name | 111 | 222 | 333 | 444 |
---|---|---|---|---|
aaa | bbb | ccc | ddd | eee |
fff | ggg | hhh | iii | 000 |
(3)原生方法
name | 111 | 222 | 333 | 444
:-: | :-: | :-: | :-: | :-:
aaa | bbb | ccc | ddd | eee|
fff | ggg| hhh | iii | 000|
效果如下:
name | 111 | 222 | 333 | 444 |
---|---|---|---|---|
aaa | bbb | ccc | ddd | eee |
fff | ggg | hhh | iii | 000 |
其他
反斜槓
Markdown 可以利用反斜槓來插入一些在語法中有其它意義的符號,例如:如果你想要用星號加在文字旁邊的方式來做出強調效果(但不用 `` 標籤),你可以在星號的前面加上反斜槓:
\*literal asterisks\*
Markdown 支持以下這些符號前面加上反斜槓來幫助插入普通的符號:
\ 反斜線
` 反引號
* 星號
_ 底線
{} 花括號
[] 方括號
() 括弧
# 井字號
+ 加號
- 減號
. 英文句點
! 驚歎號