Markdown語法全面詳解

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>&lt;blink&gt;</code> tags.</p>

你也可以這樣寫:
&#8212;` is the decimal-encoded equivalent of `&mdash;`.

以產生:

`Please don't use any `<blink>` tags.
<p><code>&amp;#8212;</code> is the decimal-encoded
equivalent of <code>&amp;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. 有序列表

顯示結果如下:

  1. 有序列表
  2. 有序列表
  3. 有序列表

(3)無序列表和有序列表同時使用

* 這是無序列表1
- 這是無序列表2
+ 這是無序列表3
1. 這是有序列表1 
2. 這是有序列表2
* 1. 有序無序混合使用1
+ 2. 有序無序混合使用2
  • 這是無序列表1
  • 這是無序列表2
  • 這是無序列表3
  1. 這是有序列表1
  2. 這是有序列表2
    1. 有序無序混合使用1
    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 支持以下這些符號前面加上反斜槓來幫助插入普通的符號:

\   反斜線
`   反引號
*   星號
_   底線
{}  花括號
[]  方括號
()  括弧
#   井字號
+   加號
-   減號
.   英文句點
!   驚歎號
發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章