*一、Markdown是什么 *
Markdown是一種輕量級的標(biāo)記語言,使用的標(biāo)記語法非常簡單庆聘,它可以使用純文本編輯器來創(chuàng)建豐富的文本貌虾,并可以被轉(zhuǎn)換為.html
吞加、.pdf
和本身的.md
文件。
二尽狠、Markdown常用語法
1. 標(biāo)題
Markdown支持兩種標(biāo)題的語法衔憨,類 Atx 和類 Setext形式。
1.1 類 Atx 形式
在文字前加#即可定義標(biāo)題袄膏,共六級標(biāo)題践图,#與標(biāo)題之間加一空格,如下:
# 一級標(biāo)題
## 二級標(biāo)題
### 三級標(biāo)題
#### 四級標(biāo)題
##### 五級標(biāo)題
###### 六級標(biāo)題
效果如下:
一級標(biāo)題
二級標(biāo)題
三級標(biāo)題
四級標(biāo)題
五級標(biāo)題
六級標(biāo)題
<br />
1.2 類 Setext 形式
個(gè)人覺得不如類Atx方便沉馆,這里就不介紹了码党,有興趣的可以參考Markdown 中文版語法說明
2. 引用
2.1 單行引用
引用別處的文字德崭,可以使用>
加引用的內(nèi)容即可,符號和引用內(nèi)容之間加一空格揖盘。
> 這里是引用的內(nèi)容
效果如下:
這里是引用的內(nèi)容
2.2 區(qū)塊引用
也可以區(qū)塊引用:
> 這里是引用區(qū)塊的內(nèi)容
> 這里是引用區(qū)塊的內(nèi)容
> 這里是引用區(qū)塊的內(nèi)容
還可以只在整個(gè)段落的第一行最前面加上>
來區(qū)塊引用:
> 這里是引用區(qū)塊的內(nèi)容眉厨,這里是引用區(qū)塊的內(nèi)容;
這里是引用區(qū)塊的內(nèi)容扣讼,這里是引用區(qū)塊的內(nèi)容缺猛。
這里是引用區(qū)塊的內(nèi)容,這里是引用區(qū)塊的內(nèi)容椭符。
效果如下:
這里是引用區(qū)塊的內(nèi)容
這里是引用區(qū)塊的內(nèi)容
這里是引用區(qū)塊的內(nèi)容
2.3 引用嵌套
區(qū)塊引用還可以嵌套使用:
> 這里是引用區(qū)塊的內(nèi)容
> > 這里是嵌套的引用區(qū)塊的內(nèi)容
效果如下:
這里是引用區(qū)塊的內(nèi)容
這里是嵌套的引用區(qū)塊的內(nèi)容
2.4 嵌套其他
引用區(qū)塊內(nèi)還可以嵌套使用其他的 Markdown 語法荔燎,如標(biāo)題、列表销钝、代碼區(qū)塊等:
> 這是引用區(qū)塊
> #引用區(qū)塊內(nèi)的標(biāo)題一
> * 引用區(qū)塊內(nèi)的列表
> \
<p>Markdown<p/>` `
效果如下:
這是引用區(qū)塊
引用區(qū)塊內(nèi)的標(biāo)題
- 引用區(qū)塊內(nèi)的列表
<p>Markdown<p/>
3. 列表
在文字前加上+
有咨、-
或者*
即可變?yōu)闊o序列表,加上1.
2.
3.
即可變?yōu)橛行蛄斜碚艚。柡土斜眄?xiàng)內(nèi)容之間加一空格座享。
3.1 無序列表
+ 無序列表項(xiàng)1
+ 無序列表項(xiàng)2
+ 無序列表項(xiàng)3
- 無序列表項(xiàng)1
- 無序列表項(xiàng)2
- 無序列表項(xiàng)3
或者
* 無序列表項(xiàng)1
* 無序列表項(xiàng)2
* 無序列表項(xiàng)3
效果如下:
- 無序列表項(xiàng)1
- 無序列表項(xiàng)2
- 無序列表項(xiàng)3
3.2 有序列表
1. 有序列表項(xiàng)1
2. 有序列表項(xiàng)2
3. 有序列表項(xiàng)3
有序列表標(biāo)記上使用的數(shù)字并不會影響輸出的結(jié)果,如下:
1. 有序列表項(xiàng)1
1. 有序列表項(xiàng)2
1. 有序列表項(xiàng)3
或者
3. 有序列表項(xiàng)1
2. 有序列表項(xiàng)2
8. 有序列表項(xiàng)3
輸出的效果都是如下所示的有序列表:
- 有序列表項(xiàng)1
- 有序列表項(xiàng)2
- 有序列表項(xiàng)3
不過建議第一個(gè)列表項(xiàng)目最好還是從1.
開始似忧,因?yàn)?Markdown 未來可能會支持有序列表的 start 屬性渣叛,即設(shè)置有序列表起始列表項(xiàng)的序列號數(shù)字。
3.3 列表縮進(jìn)
列表項(xiàng)標(biāo)記也可以縮進(jìn)盯捌,最多 3 個(gè)空格淳衙,項(xiàng)目標(biāo)記后面則一定要接著至少一個(gè)空格或制表符。
列表項(xiàng)標(biāo)記也可以包含多個(gè)段落饺著,每個(gè)項(xiàng)目下的段落都必須縮進(jìn) 4 個(gè)空格或 1 個(gè)制表符箫攀。
當(dāng)我們需要讓列表看起來更漂亮?xí)r,就可以把內(nèi)容用固定的縮進(jìn)整理好幼衰。
* 這里是列表項(xiàng)內(nèi)容這里是列表項(xiàng)內(nèi)容這里是列表項(xiàng)內(nèi)容這里是列表項(xiàng)靴跛, 內(nèi)容這里是列表項(xiàng)內(nèi)容這里是列表項(xiàng)內(nèi)容這里是列表項(xiàng)內(nèi)容這里是列表。 項(xiàng)內(nèi)容這里是列表項(xiàng)內(nèi)容這里是列表項(xiàng)內(nèi)容這里是列表項(xiàng)內(nèi)容渡嚣。
* 這里是列表項(xiàng)內(nèi)容這里是列表項(xiàng)內(nèi)容這里是列表項(xiàng)內(nèi)容這里是列表項(xiàng)梢睛, 內(nèi)容這里是列表項(xiàng)內(nèi)容這里是列表項(xiàng)內(nèi)容這里是列表項(xiàng)內(nèi)容這里是列表; 項(xiàng)內(nèi)容這里是列表項(xiàng)內(nèi)容這里是列表項(xiàng)內(nèi)容這里是列表項(xiàng)內(nèi)容识椰。
或者不整理:
* 這里是列表項(xiàng)內(nèi)容這里是列表項(xiàng)內(nèi)容這里是列表項(xiàng)內(nèi)容這里是列表項(xiàng)扬绪, 內(nèi)容這里是列表項(xiàng)內(nèi)容這里是列表項(xiàng)內(nèi)容這里是列表項(xiàng)內(nèi)容這里是列表。 項(xiàng)內(nèi)容這里是列表項(xiàng)內(nèi)容這里是列表項(xiàng)內(nèi)容這里是列表項(xiàng)內(nèi)容裤唠。
* 這里是列表項(xiàng)內(nèi)容這里是列表項(xiàng)內(nèi)容這里是列表項(xiàng)內(nèi)容這里是列表項(xiàng), 內(nèi)容這里是列表項(xiàng)內(nèi)容這里是列表項(xiàng)內(nèi)容這里是列表項(xiàng)內(nèi)容這里是列表莹痢; 項(xiàng)內(nèi)容這里是列表項(xiàng)內(nèi)容這里是列表項(xiàng)內(nèi)容這里是列表項(xiàng)內(nèi)容种蘸。
效果是一樣的墓赴,如下:
- 這里是列表項(xiàng)內(nèi)容這里是列表項(xiàng)內(nèi)容這里是列表項(xiàng)內(nèi)容這里是列表項(xiàng),
內(nèi)容這里是列表項(xiàng)內(nèi)容這里是列表項(xiàng)內(nèi)容這里是列表項(xiàng)內(nèi)容這里是列表航瞭。
項(xiàng)內(nèi)容這里是列表項(xiàng)內(nèi)容這里是列表項(xiàng)內(nèi)容這里是列表項(xiàng)內(nèi)容诫硕。 - 這里是列表項(xiàng)內(nèi)容這里是列表項(xiàng)內(nèi)容這里是列表項(xiàng)內(nèi)容這里是列表項(xiàng),
內(nèi)容這里是列表項(xiàng)內(nèi)容這里是列表項(xiàng)內(nèi)容這里是列表項(xiàng)內(nèi)容這里是列表刊侯;
項(xiàng)內(nèi)容這里是列表項(xiàng)內(nèi)容這里是列表項(xiàng)內(nèi)容這里是列表項(xiàng)內(nèi)容章办。
3.4 列表嵌套其他內(nèi)容
在列表項(xiàng)目內(nèi)放引用時(shí),>
需要縮進(jìn)滨彻。放代碼區(qū)塊的話藕届,該區(qū)塊就需要縮進(jìn)* 兩次*,也就是 8 個(gè)空格或者 2 個(gè)制表符亭饵。
* 列表項(xiàng)
> 引用
* 列表項(xiàng)
<p>這里是代碼<p/>
效果如下:
- 列表項(xiàng)
引用
- 列表項(xiàng)
<p>這里是代碼<p/>
3.5 意外列表
無意中產(chǎn)生的列表:
1986. What a great season.
效果如下:
- What a great season.
可以做如下處理:
1986\. What a great season.
效果如下:
1986. What a great season.
也就是在行首出現(xiàn)數(shù)字-句點(diǎn)-空白休偶,要避免這樣的狀況,可以在句點(diǎn)前面加上反斜杠轉(zhuǎn)義辜羊。
4. 代碼區(qū)塊與分割線
4.1 代碼區(qū)塊
Markdown 中建立代碼區(qū)塊很簡單踏兜,只要簡單地縮進(jìn) 4 個(gè)空格或是 1 個(gè)制表符就可以了。不過貌似簡書需要兩個(gè)制表符才行八秃。
<h2>代碼區(qū)塊的標(biāo)題<h2/>
<p>代碼區(qū)塊的內(nèi)容<p/>
效果如下:
<h2>代碼區(qū)塊的標(biāo)題<h2/>
<p>代碼區(qū)塊的內(nèi)容<p/>
一個(gè)代碼區(qū)塊會一直持續(xù)到?jīng)]有縮進(jìn)的那一行(或是文件結(jié)尾)碱妆。
如果要標(biāo)記一小段行內(nèi)代碼,你可以用反引號`把它包起來昔驱。如\
<p> <p/>` 效果為
<p> <p/>`疹尾。
4.4 分割線
在一行中用三個(gè)以上的星號、減號舍悯、底下劃線來建立一個(gè)分隔線航棱,行內(nèi)不能有其他東西。不過可以在星號或是減號中間插入空格萌衬。
***
---
___
* * *
- - -
_ _ _
效果一樣的饮醇,如下:
如果要做連續(xù)的下劃線,最好在每一行的符號后面加一空行秕豫,不然可能會出問題朴艰,不知是簡書這樣還是都是這樣。
5. 鏈接與圖片
插入鏈接與插入圖片的語法很像混移,區(qū)別在于插入圖片前面多一個(gè)感嘆號!
祠墅。
5.1 插入鏈接
[鏈接描述](這里是鏈接的地址)
效果如下:
這里是鏈接的描述
5.2 插入圖片
插入圖片的地址需要圖床,別人推薦 CloudApp 的服務(wù)歌径,生成URL地址即可毁嗦。ps:我沒有用過<sub />
簡書可以直接把圖片拖過來。
![圖片描述](圖片URL "圖片title")
<small>——圖片title是可選項(xiàng)<small />
效果如下:
6. 強(qiáng)調(diào)和轉(zhuǎn)義
Markdown 使用星號*
和底線_
作為標(biāo)記強(qiáng)調(diào)字詞的符號回铛。
用一個(gè)*
或者_
包含一段文本得到的是斜體狗准,用兩個(gè)*
或者_
包含一段文本得到的是粗體克锣。開始和結(jié)束的符號要相同。轉(zhuǎn)義在前面加上轉(zhuǎn)義字符 \ 即可腔长,如:*袭祟。
*斜體*
**粗體**
_斜體_
__粗體__
效果如下:
斜體 粗體斜體 粗體
*
和_
兩邊都有空白的話,它們就只會被當(dāng)成普通的符號捞附。如*
結(jié)果就是 *巾乳, _
結(jié)果就是 _ 。
如果要在文字前后直接插入普通的星號或底線鸟召,你可以用反斜線轉(zhuǎn)義胆绊。如\*
結(jié)果就是*, \_
結(jié)果就是 _ 药版。
6. 表格
表格是比較麻煩的
|表頭 |表頭|表頭|表頭| | -|:--| ---:| :----:| |單元格| |單元格|單元格| |單元格|單元格|單元格|單元格| |單元格|單元格|單元格|單元格|
-
||
表示空單元格 - 表頭下一行中
-
數(shù)量無關(guān)單元格寬度辑舷,根據(jù)列數(shù)均分寬度 - 表頭下一行中的
:
表示的是文字的對齊方式,不設(shè)置則只是表頭文字居中槽片;在-
左邊則居左何缓,右邊居右,在-
兩邊各有一個(gè):
則居中 - 合并單元格等其他單元格有關(guān)內(nèi)容另行搜索
效果如下:
表格與整個(gè)表格前面的文字之間需要加一空行还栓。
表頭 | 表頭 | 表頭 | 表頭 |
---|---|---|---|
單元格 | 單元格 | 單元格 | |
單元格 | 單元格 | 單元格 | 單元格 |
單元格 | 單元格 | 單元格 | 單元格 |
總結(jié)
以上是我在簡書上學(xué)習(xí)使用Markdown的練習(xí)碌廓,感覺<big>空一行<big />好重要啊,很多時(shí)候因?yàn)闆]有空一行都會導(dǎo)致一些意外剩盒。
本文主要參考Markdown 中文版語法說明谷婆。如果想要了解更多有關(guān)Markdown語法的內(nèi)容,請閱讀Markdown 中文版語法說明辽聊。