Markdown 語法彙總

拱大塏發表於2019-06-15

部落格園也能Markdown?美滋滋,Markdown真的是好用QAQ。
本文件按照Markdown各種常用語法類別,以文字描述+演示的方式來展現markdown語法的使用。Markdown 的目標是實現[易讀易寫],成為一種適用於網路的書寫語言。HTML 是一種釋出的格式,Markdown 是一種書寫的格式,Markdown 的格式語法只涵蓋純文字可以涵蓋的範圍,Markdown 語法相容HTML語法。

段落和換行

一個 Markdown 段落是由一個或多個連續的文字行組成,它的前後要有一個以上的空行。普通的Markdown 段落不可以用空格或製表符來縮排。

空行:一行之內只包含回車換行、空格、製表符。

標題

Markdown 支援兩種標題的語法,類 Setext 和類 atx 形式。

(1)類 Setext 形式

類 Setext 形式語法是使用用標題下底線的形式,包括 = (一級標題)和 - (二級標題),任何數量的 = 和 - 都可以有效果。 例如:

一級標題下加=

二級標題下加-

(2)類 atx 形式

類 Atx 形式則是在行首插入 1 到 6 個 # ,#和標題文字之間使用一個或多個空格,對應到標題 1 到 6 級, 例如:

這是 H1

這是 H2

這是 H3

強調

Markdown 使用星號(*)和下滑線(_)作為標記強調字詞的符號,例如:

斜體
加粗

但是如果你的*和 _ 兩邊都有空白的話,它們就只會被當成普通的符號。如果要在文字前後直接插入普通的星號或下劃線,你可以用反斜線: 例如: 使用反斜線開頭的被當做是普通的字元*

區塊引用

Markdown 標記區塊引用的方法是在行的最前面加 > ,也可以只在整個段落的第一行最前面加上 >,區塊引用內部可以巢狀,只要根據層次加上不同數量的 >即可,引用的區塊內也可以使用其他的 Markdown 語法,包括標題、列表、程式碼區塊等。 例如:

Markdown 標記區塊引用的方法是在行的最前面加> 也可以只在整個段落的第一行最前面加上 >

區塊引用內部可以巢狀,只要根據層次加上不同數量的 >即可.我是內部巢狀區塊,我可以使用其他Markdown 語法哦

我是引用區塊內使用標題3語法

在引用區塊內可以加入程式碼塊 import java.net.URL; import java.util.Arrays; import java.util.Date; import java.util.Set;

列表

Markdown 支援有序列表和無序列表,無序列表使用星號、加號或是減號作為列表標記,有序列表則使用數字接著一個英文句點。兩種列表方式格式都是:列表標記+空格+列表項,即列表專案標記通常是放在最左邊,也可以縮排最多 3 個空格,專案標記後面則一定要接著至少一個空格或製表符。

(1)無序列表

星號、加號或是減號三種列表方式效果等同。 例如:

*Red

*Green

*Blue

星號列表

*   Red
*   Green
*   Blue

加號列表

*Red
*Green
*Blue

減號列表

*Red
*Green
*Blue

(2)有序列表

有序列表則使用數字接著一個英文句點. 例如:

1.Red

2.Green

3.Blue

程式碼塊
同各種程式語言相關的寫作或是標籤語言原始碼通常會有已經排版好的程式碼塊,通常這些程式碼塊我們並不希望它以一般段落的方式去排版,而是照原來的樣子顯示。 Markdown建立程式碼塊的方法:只要在行最前面簡單地縮排 4 個空格或是 1 個製表符就可以,一個程式碼區塊會一直持續到沒有縮排的那一行。

這是一個程式碼區塊。
只要簡單地縮排 4 個空格或是 1 個製表符就可以
一個程式碼區塊會一直持續到沒有縮排的那一行

小段程式碼

需要引用程式碼時,如果引用的語句只有一段,不分行,可以用 ` 將語句包起來。 如果引用的語句為多行,可以將```置於這段程式碼的首行和末行。

​```cpp
#include<iostream>
​```

分隔線

可以在一行中用三個以上的星號、減號、底線來建立一個分隔線,行內不能有其他內容。也可以在星號或是減號中間插入空格。下面每種寫法都可以建立分隔線:

* * *

***

*****

- - -

---------------------------------------





連結

在方塊括號後面緊接著圓括號並插入網址連結即可,如果你還想要加上鍊接的 title 文字,只要在網址後面,用雙引號把 title 文字包起來即可,例如: 這是 行內式連結標題 內聯方式.

[行內式連結標題](https://www.cnblogs.com/gongdakai/)

圖片

Markdown 使用一種和連結很相似的語法來標記圖片。

行內式的圖片語法如下: ![圖片下方文字](圖片相對路徑或絕對路徑) ![圖片下方文字](圖片相對路徑或絕對路徑 "可選標題") 詳細敘述如下: 一個驚歎號 ! 接著一個方括號,裡面放上圖片的替代文字,接著一個普通括號,裡面放上圖片的網址,最後還可以用引號包住並加上 選擇性的 'title' 文字。

自動連結

Markdown 支援以比較簡短的自動連結形式來處理網址和電子郵件信箱,只要是用方括號包起來, Markdown 就會自動把它轉成連結。一般網址的連結文字就和連結地址一樣。

反斜槓

Markdown 可以利用反斜槓來插入一些在語法中有其它意義的符號,例如:如果你想要用星號加在文字旁邊的方式來做出強調效果,你可以在星號的前面加上反斜槓: Markdown 支援以下這些符號前面加上反斜槓來幫助插入普通的符號:

\   反斜線
`   反引號
*   星號
_   底線
{}  花括號
[]  方括號
()  括弧
#   井字號
+   加號
-   減號
.   英文句點
!   驚歎號