@Author : Roger TX (425144880@qq.com)
@Link : https://github.com/paotong999
markdown常用語(yǔ)法主要包含區(qū)塊元素赂乐、區(qū)段元素和一些其他特定語(yǔ)法
區(qū)塊元素
1但汞、標(biāo)題
Markdown 支持兩種標(biāo)題的語(yǔ)法迈套,類 Setext 和類 atx 形式嘶摊。
類 Setext 形式是用底線的形式,利用 = (最高階標(biāo)題)和 - (第二階標(biāo)題)
類 Atx 形式則是在行首插入 1 到 6 個(gè) # ,對(duì)應(yīng)到標(biāo)題 1 到 6 階,例如:
# 這是 H1
## 這是 H2
###### 這是 H6
這是 H1
這是 H2
這是 H6
2呼猪、區(qū)塊引用
Markdown 文件中建立一個(gè)區(qū)塊引用,那會(huì)看起來(lái)像是你自己先斷好行砸琅,然后在每行的最前面加上 > :
Markdown 也允許你偷懶只在整個(gè)段落的第一行最前面加上 > :
> Donec sit amet nisl. Aliquam semper ipsum sit amet velit. Suspendisse
id sem consectetuer libero luctus adipiscing.
> Donec sit amet nisl. Aliquam semper ipsum sit amet velit. Suspendisse
id sem consectetuer libero luctus adipiscing.
Donec sit amet nisl. Aliquam semper ipsum sit amet velit. Suspendisse
id sem consectetuer libero luctus adipiscing.
Donec sit amet nisl. Aliquam semper ipsum sit amet velit. Suspendisse
id sem consectetuer libero luctus adipiscing.
區(qū)塊引用可以嵌套(例如:引用內(nèi)的引用)宋距,只要根據(jù)層次加上不同數(shù)量的 > :
> This is the first level of quoting.
>
> > This is nested blockquote.
>
> Back to the first level.
引用的區(qū)塊內(nèi)也可以使用其他的 Markdown 語(yǔ)法,包括標(biāo)題症脂、列表谚赎、代碼區(qū)塊等
3、列表
Markdown 支持有序列表和無(wú)序列表
無(wú)序列表使用星號(hào)诱篷、加號(hào)或是減號(hào)作為列表標(biāo)記:
+ Red
+ Green
+ Blue
- Red
- Green
- Blue
有序列表則使用數(shù)字接著一個(gè)英文句點(diǎn):
1. Bird
3. McHale
5. Parish
- Bird
- McHale
- Parish
任務(wù)列表
- [x] 選項(xiàng)一
- [ ] 選項(xiàng)二
- [x] 選項(xiàng)一
- [ ] 選項(xiàng)二
列表項(xiàng)目可以包含多個(gè)段落壶唤,每個(gè)項(xiàng)目下的段落都必須縮進(jìn) 4 個(gè)空格或是 1 個(gè)制表符
如果要放代碼區(qū)塊的話,該區(qū)塊就需要縮進(jìn)兩次棕所,也就是 8 個(gè)空格或是 2 個(gè)制表符
4视粮、代碼區(qū)塊
要在 Markdown 中建立代碼區(qū)塊很簡(jiǎn)單,只要簡(jiǎn)單地縮進(jìn) 4 個(gè)空格或是 1 個(gè)制表符就可以橙凳,例如,下面的輸入:
這是一個(gè)普通段落:
這是一個(gè)代碼區(qū)塊笑撞。
代碼區(qū)塊中岛啸,一般的 Markdown 語(yǔ)法不會(huì)被轉(zhuǎn)換,像是星號(hào)便只是星號(hào)茴肥,這表示你可以很容易地以 Markdown 語(yǔ)法撰寫 Markdown 語(yǔ)法相關(guān)的文件坚踩。
用```也可以生成塊
這是一個(gè)代碼區(qū)塊。
5瓤狐、分隔線
你可以在一行中用三個(gè)以上的星號(hào)瞬铸、減號(hào)批幌、底線來(lái)建立一個(gè)分隔線,行內(nèi)不能有其他東西嗓节。你也可以在星號(hào)或是減號(hào)中間插入空格荧缘。
* * *
區(qū)段元素
1、鏈接
Markdown 支持兩種形式的鏈接語(yǔ)法: 行內(nèi)式和參考式兩種形式拦宣。
行內(nèi)式的鏈接:鏈接文字用 [方括號(hào)] 來(lái)標(biāo)記截粗,括號(hào)后面緊接著圓括號(hào)并插入網(wǎng)址鏈接即可
如果你是要鏈接到同樣主機(jī)的資源,你可以使用相對(duì)路徑:
This is [an example](http://example.com/ "Title") inline link.
See my [About](/about/) page for details.
參考式的鏈接:鏈接文字用 [方括號(hào)] 標(biāo)記鸵隧,括號(hào)后面再接上另一個(gè)方括號(hào)绸罗,在第二個(gè)方括號(hào)里面填入用以辨識(shí)鏈接的標(biāo)記
之后,在文件的任意處豆瘫,你可以把這個(gè)標(biāo)記的鏈接內(nèi)容定義出來(lái):
This is [an example][id] reference-style link.
This is [an example] [id] reference-style link.
[id]: http://example.com/ "Optional Title Here"
鏈接內(nèi)容定義的形式為:
- 方括號(hào)(前面可以選擇性地加上至多三個(gè)空格來(lái)縮進(jìn))庄萎,里面輸入鏈接文字
- 接著一個(gè)冒號(hào)
- 接著一個(gè)以上的空格或制表符
- 接著鏈接的網(wǎng)址
- 選擇性地接著 title 內(nèi)容,可以用單引號(hào)猛遍、雙引號(hào)或是括弧包著
下面這三種鏈接的定義都是相同:
[foo]: http://example.com/ "Optional Title Here"
[foo]: http://example.com/ 'Optional Title Here'
[foo]: http://example.com/ (Optional Title Here)
2螃征、強(qiáng)調(diào)
Markdown 使用星號(hào)(*)和底線(_)作為標(biāo)記強(qiáng)調(diào)字詞的符號(hào)
被 * 或 _ 包圍的字詞會(huì)被轉(zhuǎn)成用 <em> 標(biāo)簽包圍,即斜體
用兩個(gè) * 或 _ 包起來(lái)的話略步,則會(huì)被轉(zhuǎn)成 <strong>描扯,即粗體
*single asterisks*
**double asterisks**
single underscores
double underscores
3、代碼
如果要標(biāo)記一小段行內(nèi)代碼趟薄,你可以用反引號(hào)把它包起來(lái)(`)
Use the `printf()` function.
A single backtick in a code span: `` ` ``
Use the printf()
function.
A single backtick in a code span: `
4绽诚、圖片
Markdown 使用一種和鏈接很相似的語(yǔ)法來(lái)標(biāo)記圖片,同樣也允許兩種樣式: 行內(nèi)式和參考式杭煎。
行內(nèi)式的圖片語(yǔ)法看起來(lái)像是:
![Alt text](/path/to/img.jpg)
![Alt text](/path/to/img.jpg "Optional title")
詳細(xì)敘述如下:
- 一個(gè)驚嘆號(hào) !
- 接著一個(gè)方括號(hào)恩够,里面放上圖片的替代文字
- 接著一個(gè)普通括號(hào),里面放上圖片的網(wǎng)址羡铲,最后還可以用引號(hào)包住并加上 選擇性的 'title' 文字蜂桶。
參考式的圖片語(yǔ)法則長(zhǎng)得像這樣:
「id」是圖片參考的名稱,圖片參考的定義方式則和連結(jié)參考一樣:
![Alt text][id]
[id]: url/to/image "Optional title attribute"
其他
1也切、自動(dòng)鏈接
Markdown 支持以比較簡(jiǎn)短的自動(dòng)鏈接形式來(lái)處理網(wǎng)址和電子郵件信箱扑媚,只要是用方括號(hào)包起來(lái), Markdown 就會(huì)自動(dòng)把它轉(zhuǎn)成鏈接雷恃。
<http://example.com/>
2疆股、反斜杠
Markdown 支持以下這些符號(hào)前面加上反斜杠來(lái)幫助插入普通的符號(hào):
\ 反斜線
` 反引號(hào)
* 星號(hào)
_ 底線
{} 花括號(hào)
[] 方括號(hào)
() 括弧
# 井字號(hào)
+ 加號(hào)
- 減號(hào)
. 英文句點(diǎn)
! 驚嘆號(hào)
3、字體顏色(html倒槐,makedown兼容一般)
<font face="黑體">我是黑體字</font>
<font face="微軟雅黑">我是微軟雅黑</font>
<font face="STCAIYUN">我是華文彩云</font>
<font color=#0099ff size=12 face="黑體">黑體</font>
<font color=#00ffff size=5>null</font>
<font color=red>gray</font>
<font face="黑體">我是黑體字</font>
<font face="微軟雅黑">我是微軟雅黑</font>
<font face="STCAIYUN">我是華文彩云</font>
<font color=#0099ff size=12 face="黑體">黑體</font>
<font color=#00ffff size=5>null</font>
<font color=red>gray</font>
4旬痹、行首空格
       《專業(yè)主義》
? ? ? ?《專業(yè)主義》
5、文字刪除線
~~文字刪除線~~
文字刪除線