標題
Markdown 中,只需要在文本前面加上“#”,就會被認為是加了一個標題。同理,你還可以增加二級、三級、四級、五級標題和六級標題,只需要增加“#” 即可。例如:
# 一級標題
## 二級標題
### 三級標題
#### 四級標題
##### 五級標題
###### 六級標題
顯示效果:
一級標題
二級標題
三級標題
四級標題
五級標題
六級標題
段落
換行
在markdown中,直接換行是沒用的,比如:
“
所有的結局都已寫好
所有的淚水也都啟程
”
寫好的格式是這樣,但是有時會顯示成
“
所有的結局都已寫好所有的淚水也都啟程
”
也就是一排顯示,這時只需要在倆行中間敲一下enter,即可換行,但是此時倆行中間間距略微偏多,這時可以在第一行末尾,敲倆個空格,也可實現效果。
縮進
在markdown中縮進:
- 半方大的空白 或 
- 全方大的空白 或 
- 不斷行的空白格 或 
列表
當你要羅列一些內容時,列表是很有用的工具。為了說明哪些條目屬于這個列表,我們需要引入“項目標記”。
列表項目標記通常放在段落開頭,后面要跟著一個空格。列表的各個條目之間可以不留空行。
無序列表
若列表中的條目沒有特定順序時,可以使用 無序列表。加號“+”或減號“-”都可以作為列表標記,后面要跟一個空格。例如:
+ 蘋果
+ 橘子
+ 梨子
或者:
- 蘋果
- 橘子
- 梨子
顯示效果:
蘋果
橘子
梨子
有序列表
若想在段落前加上數字序號,就需要用到有序列表了。使用數字、一個英文句號和一個空格即可。例如:
1. 蘋果
2. 橘子
3. 梨子
顯示效果:
蘋果
橘子
梨子
多級列表
圖片
Markdown 中可以插入圖片,只需要感嘆號、方括號和圓括號即可。例如:

一個英文感嘆號 “!” 后緊跟方括號,里面可以寫這張圖片的說明;再緊跟一對圓括號,里面寫這張圖片的網址。例如:
顯示效果:
當然,如果你只是想單純上傳一張圖片,不想有文字描述,把文字去掉就可以了:
顯示效果:
鏈接
在文檔中插入連接的語法和插入圖片的語法很像,只是少了最前面的英文感嘆號"!"。
在方括號寫下鏈接文字,圓括號寫下網址即可。
外部鏈接
[這是簡書的首頁](http://www.lxweimin.com/)
顯示效果:
內部鏈接1
鏈接到倉庫中(github)的其他文件:
[demo1](demo1.md)
顯示效果:
demo1
點擊的話會跳轉到demo1.md文件
內部鏈接2
鏈接到本文檔的其他部分(類似于html的錨點)
[代碼塊 demo](demo2.md#代碼塊-demo)
效果:
代碼塊 demo
引用式鏈接
這個鏈接就是在文檔某處(一般是文檔尾部),定義好,用的地方直接使用:
<!--下面是本文檔中可能用到的鏈接-->
[簡書]:http://www.lxweimin.com
使用時,直接書寫 “[百度]” 即可實現鏈接效果
強調
在Markdown中,可以使用 * 和 _ 來表示斜體和加粗。需要注意的是,“_”是下劃線而非減號“-”。
斜體
在需要斜體的文本左右各加一個“*”或“_” ,例如:
*所謂美好的心靈,就是能體貼萬物的心,能溫柔對待一草一木的心靈。*
_所謂美好的心靈,就是能體貼萬物的心,能溫柔對待一草一木的心靈。_
顯示效果:
所謂美好的心靈,就是能體貼萬物的心,能溫柔對待一草一木的心靈。
加粗
在需要加粗的文本左右各加兩個“*”或“_” ,例如:
**所謂美好的心靈,就是能體貼萬物的心,能溫柔對待一草一木的心靈。**
__所謂美好的心靈,就是能體貼萬物的心,能溫柔對待一草一木的心靈。__
顯示效果:
所謂美好的心靈,就是能體貼萬物的心,能溫柔對待一草一木的心靈。
斜體并加粗
在需要斜體并加粗的文本左右各加三個“*”或“_” ,例如:
***所謂美好的心靈,就是能體貼萬物的心,能溫柔對待一草一木的心靈。***
___所謂美好的心靈,就是能體貼萬物的心,能溫柔對待一草一木的心靈。___
顯示效果:
所謂美好的心靈,就是能體貼萬物的心,能溫柔對待一草一木的心靈。
刪除線
在文字倆旁各加2個 “~” 即可實現刪除線的效果:
~~¥199.00~~
顯示效果:
¥199.00
引用
可以使用">" 標記來引用其他人的言論、書籍或報紙的內容。只需要在段落的第一行最前面加上 > 即可,例如:
> 青春不是玫瑰,青春是伏特加酒,看起來不怎么樣,喝光的時候,才知道它的后勁滿強。 —— 林清玄 《你心柔軟,卻有力量》
顯示效果:
青春不是玫瑰,青春是伏特加酒,看起來不怎么樣,喝光的時候,才知道它的后勁滿強。 ——林清玄 《你心柔軟,卻有力量》
在引用的區域內,也可以使用其他的 Markdown 語法,包括標題、列表等,例如:
> *青春不是玫瑰,青春是伏特加酒,看起來不怎么樣,喝光的時候,才知道它的后勁滿強。* ——林清玄 《你心柔軟,卻有力量》
顯示效果:
青春不是玫瑰,青春是伏特加酒,看起來不怎么樣,喝光的時候,才知道它的后勁滿強。 ——林清玄 《你心柔軟,卻有力量》
分割線
在 Markdown 中,可以用分隔線來將內容分成不同區域。
這里有三種寫法,三個“-”、三個“*”、三個“_”,都可實現分割線的效果:
- ---
- ***
- ___
顯示效果都是:
簡書中編輯代碼
在markdown中編輯代碼段,分為塊式代碼和行內代碼
塊式代碼
可以切換英文輸入法,開頭和結尾各打三個 “ ``` ”,即可,例如:
```
let add = ( ...val )=>{ // 不定參數求和
var result = 0;
for( var i = 0; i < val.length; i++ ){
result += val[i];
}
return result;
}
console.log( add( 100, 200 ) ); // 300
```
顯示效果:
let add = ( ...val )=>{ // 不定參數求和
let result = 0;
for( let i = 0; i < val.length; i++ ){
result += val[i];
}
return result;
}
console.log( add( 100, 200 ) ); // 300
行內代碼
代碼的開頭和結尾各打一個 "`" 即可:
我們如果要在瀏覽器中彈出信息,可以使用`alert( " hello " )`。
效果:
我們如果要在瀏覽器中彈出信息,可以使用alert( " hello " )
表格
表格有時是挺有用的,這里講解一下,一個基礎的表格實現方式:
| 姓名 | 年齡 | 性別 |
| ----- | ----- | ----- |
| tom | 23 | 男 |
| jack | 18 | 男 |
| alice | 22 | 女 |
效果:
姓名 | 年齡 | 性別 |
---|---|---|
tom | 23 | 男 |
jack | 18 | 男 |
alice | 22 | 女 |
這里可以定義表格的對齊方式,分別是居左對齊(默認)、居中對齊、居右對齊,實現方式就是:
| 姓名 | 年齡 | 性別 |
| :----- | :-----: | -----: |
| tom | 23 | 男 |
| jack | 18 | 男 |
| alice | 22 | 女 |
也就是在不同的位置加冒號,效果:
姓名 | 年齡 | 性別 |
---|---|---|
tom | 23 | 男 |
jack | 18 | 男 |
alice | 22 | 女 |
表情
經測試,github是支持添加emoji表情的,輸入不同的符號碼(倆個冒號包圍的字符),可以顯示出不同的表情,比如笑臉:
:smile:
以下是部分表情:
復雜場景的實現
圖片鏈接
一張圖片鏈接到百度
[](https://www.baidu.com)
效果:
混合強調樣式
- ***加粗傾斜***
- **~~加粗刪除~~**
- ***~~加粗傾斜刪除~~***
效果:
- 加粗傾斜
加粗刪除加粗傾斜刪除