*一、Markdown是什么 *
Markdown是一種輕量級的標記語言,使用的標記語法非常簡單,它可以使用純文本編輯器來創(chuàng)建豐富的文本,并可以被轉(zhuǎn)換為.html、.pdf和本身的.md文件。
二、Markdown常用語法
1. 標題
Markdown支持兩種標題的語法,類 Atx 和類 Setext形式。
1.1 類 Atx 形式
在文字前加#即可定義標題,共六級標題,#與標題之間加一空格,如下:
# 一級標題
## 二級標題
### 三級標題
#### 四級標題
##### 五級標題
###### 六級標題
效果如下:
一級標題
二級標題
三級標題
四級標題
五級標題
六級標題
<br />
1.2 類 Setext 形式
個人覺得不如類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)容
還可以只在整個段落的第一行最前面加上>來區(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 語法,如標題、列表、代碼區(qū)塊等:
> 這是引用區(qū)塊
> #引用區(qū)塊內(nèi)的標題一
> * 引用區(qū)塊內(nèi)的列表
> \ <p>Markdown<p/>` `
效果如下:
這是引用區(qū)塊
引用區(qū)塊內(nèi)的標題
- 引用區(qū)塊內(nèi)的列表
<p>Markdown<p/>
3. 列表
在文字前加上+、-或者*即可變?yōu)闊o序列表,加上1. 2. 3. 即可變?yōu)橛行蛄斜?,符號和列表項?nèi)容之間加一空格。
3.1 無序列表
+ 無序列表項1
+ 無序列表項2
+ 無序列表項3
- 無序列表項1
- 無序列表項2
- 無序列表項3
或者
* 無序列表項1
* 無序列表項2
* 無序列表項3
效果如下:
- 無序列表項1
- 無序列表項2
- 無序列表項3
3.2 有序列表
1. 有序列表項1
2. 有序列表項2
3. 有序列表項3
有序列表標記上使用的數(shù)字并不會影響輸出的結(jié)果,如下:
1. 有序列表項1
1. 有序列表項2
1. 有序列表項3
或者
3. 有序列表項1
2. 有序列表項2
8. 有序列表項3
輸出的效果都是如下所示的有序列表:
- 有序列表項1
- 有序列表項2
- 有序列表項3
不過建議第一個列表項目最好還是從1. 開始,因為 Markdown 未來可能會支持有序列表的 start 屬性,即設(shè)置有序列表起始列表項的序列號數(shù)字。
3.3 列表縮進
列表項標記也可以縮進,最多 3 個空格,項目標記后面則一定要接著至少一個空格或制表符。
列表項標記也可以包含多個段落,每個項目下的段落都必須縮進 4 個空格或 1 個制表符。
當我們需要讓列表看起來更漂亮?xí)r,就可以把內(nèi)容用固定的縮進整理好。
* 這里是列表項內(nèi)容這里是列表項內(nèi)容這里是列表項內(nèi)容這里是列表項, 內(nèi)容這里是列表項內(nèi)容這里是列表項內(nèi)容這里是列表項內(nèi)容這里是列表。 項內(nèi)容這里是列表項內(nèi)容這里是列表項內(nèi)容這里是列表項內(nèi)容。
* 這里是列表項內(nèi)容這里是列表項內(nèi)容這里是列表項內(nèi)容這里是列表項, 內(nèi)容這里是列表項內(nèi)容這里是列表項內(nèi)容這里是列表項內(nèi)容這里是列表; 項內(nèi)容這里是列表項內(nèi)容這里是列表項內(nèi)容這里是列表項內(nèi)容。
或者不整理:
* 這里是列表項內(nèi)容這里是列表項內(nèi)容這里是列表項內(nèi)容這里是列表項, 內(nèi)容這里是列表項內(nèi)容這里是列表項內(nèi)容這里是列表項內(nèi)容這里是列表。 項內(nèi)容這里是列表項內(nèi)容這里是列表項內(nèi)容這里是列表項內(nèi)容。
* 這里是列表項內(nèi)容這里是列表項內(nèi)容這里是列表項內(nèi)容這里是列表項, 內(nèi)容這里是列表項內(nèi)容這里是列表項內(nèi)容這里是列表項內(nèi)容這里是列表; 項內(nèi)容這里是列表項內(nèi)容這里是列表項內(nèi)容這里是列表項內(nèi)容。
效果是一樣的,如下:
- 這里是列表項內(nèi)容這里是列表項內(nèi)容這里是列表項內(nèi)容這里是列表項,
內(nèi)容這里是列表項內(nèi)容這里是列表項內(nèi)容這里是列表項內(nèi)容這里是列表。
項內(nèi)容這里是列表項內(nèi)容這里是列表項內(nèi)容這里是列表項內(nèi)容。 - 這里是列表項內(nèi)容這里是列表項內(nèi)容這里是列表項內(nèi)容這里是列表項,
內(nèi)容這里是列表項內(nèi)容這里是列表項內(nèi)容這里是列表項內(nèi)容這里是列表;
項內(nèi)容這里是列表項內(nèi)容這里是列表項內(nèi)容這里是列表項內(nèi)容。
3.4 列表嵌套其他內(nèi)容
在列表項目內(nèi)放引用時,> 需要縮進。放代碼區(qū)塊的話,該區(qū)塊就需要縮進* 兩次*,也就是 8 個空格或者 2 個制表符。
* 列表項
> 引用
* 列表項
<p>這里是代碼<p/>
效果如下:
- 列表項
引用
- 列表項
<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ù)字-句點-空白,要避免這樣的狀況,可以在句點前面加上反斜杠轉(zhuǎn)義。
4. 代碼區(qū)塊與分割線
4.1 代碼區(qū)塊
Markdown 中建立代碼區(qū)塊很簡單,只要簡單地縮進 4 個空格或是 1 個制表符就可以了。不過貌似簡書需要兩個制表符才行。
<h2>代碼區(qū)塊的標題<h2/>
<p>代碼區(qū)塊的內(nèi)容<p/>
效果如下:
<h2>代碼區(qū)塊的標題<h2/>
<p>代碼區(qū)塊的內(nèi)容<p/>
一個代碼區(qū)塊會一直持續(xù)到?jīng)]有縮進的那一行(或是文件結(jié)尾)。
如果要標記一小段行內(nèi)代碼,你可以用反引號`把它包起來。如\ <p> <p/>` 效果為 <p> <p/>`。
4.4 分割線
在一行中用三個以上的星號、減號、底下劃線來建立一個分隔線,行內(nèi)不能有其他東西。不過可以在星號或是減號中間插入空格。
***
---
___
* * *
- - -
_ _ _
效果一樣的,如下:
如果要做連續(xù)的下劃線,最好在每一行的符號后面加一空行,不然可能會出問題,不知是簡書這樣還是都是這樣。
5. 鏈接與圖片
插入鏈接與插入圖片的語法很像,區(qū)別在于插入圖片前面多一個感嘆號! 。
5.1 插入鏈接
[鏈接描述](這里是鏈接的地址)
效果如下:
這里是鏈接的描述
5.2 插入圖片
插入圖片的地址需要圖床,別人推薦 CloudApp 的服務(wù),生成URL地址即可。ps:我沒有用過<sub />
簡書可以直接把圖片拖過來。
 <small>——圖片title是可選項<small />
效果如下:

6. 強調(diào)和轉(zhuǎn)義
Markdown 使用星號*和底線_作為標記強調(diào)字詞的符號。
用一個*或者_包含一段文本得到的是斜體,用兩個*或者_ 包含一段文本得到的是粗體。開始和結(jié)束的符號要相同。轉(zhuǎn)義在前面加上轉(zhuǎn)義字符 \ 即可,如:*。
*斜體*
**粗體**
_斜體_
__粗體__
效果如下:
斜體 粗體斜體 粗體
* 和_兩邊都有空白的話,它們就只會被當成普通的符號。如*結(jié)果就是 *, _結(jié)果就是 _ 。
如果要在文字前后直接插入普通的星號或底線,你可以用反斜線轉(zhuǎn)義。如\*結(jié)果就是*, \_結(jié)果就是 _ 。
6. 表格
表格是比較麻煩的
|表頭 |表頭|表頭|表頭| | -|:--| ---:| :----:| |單元格| |單元格|單元格| |單元格|單元格|單元格|單元格| |單元格|單元格|單元格|單元格|
-
||表示空單元格 - 表頭下一行中
-數(shù)量無關(guān)單元格寬度,根據(jù)列數(shù)均分寬度 - 表頭下一行中的
:表示的是文字的對齊方式,不設(shè)置則只是表頭文字居中;在-左邊則居左,右邊居右,在-兩邊各有一個:則居中 - 合并單元格等其他單元格有關(guān)內(nèi)容另行搜索
效果如下:
表格與整個表格前面的文字之間需要加一空行。
| 表頭 | 表頭 | 表頭 | 表頭 |
|---|---|---|---|
| 單元格 | 單元格 | 單元格 | |
| 單元格 | 單元格 | 單元格 | 單元格 |
| 單元格 | 單元格 | 單元格 | 單元格 |
總結(jié)
以上是我在簡書上學(xué)習(xí)使用Markdown的練習(xí),感覺<big>空一行<big />好重要啊,很多時候因為沒有空一行都會導(dǎo)致一些意外。
本文主要參考Markdown 中文版語法說明。如果想要了解更多有關(guān)Markdown語法的內(nèi)容,請閱讀Markdown 中文版語法說明。