第12篇
一、Markdown常用語(yǔ)法
Markdown 是一種易于閱讀、易于撰寫的純文字格式的標(biāo)記語(yǔ)言,可以轉(zhuǎn)換成HTML蜈块,越來(lái)越多的人用它寫文章。簡(jiǎn)書就支持markdown渴邦,在簡(jiǎn)書預(yù)覽模式下寫作非常直觀高效疯趟。
常用的語(yǔ)法包括 標(biāo)題、列表谋梭、引用信峻、鏈接、圖片瓮床、粗斜體及代碼盹舞。
1. 標(biāo)題
井號(hào)表示標(biāo)題产镐,字號(hào)隨井號(hào)數(shù)量增多而變小,一個(gè)是一級(jí)踢步,最多6級(jí)癣亚。一般到4級(jí)就足夠使用了。
標(biāo)題寫法
# 一級(jí)標(biāo)題
## 二級(jí)標(biāo)題
### 三級(jí)標(biāo)題
#### 四級(jí)標(biāo)題
標(biāo)題顯示效果
一級(jí)標(biāo)題
二級(jí)標(biāo)題
三級(jí)標(biāo)題
四級(jí)標(biāo)題
2. 列表
列表分兩種获印,有序列表和無(wú)序列表述雾。
有序列表寫法
阿拉伯?dāng)?shù)字+小數(shù)點(diǎn)+空格,空格不能丟兼丰。而且數(shù)字寫錯(cuò)也沒(méi)關(guān)系玻孟,markdown會(huì)自動(dòng)修正為正確順序。
1. 第一條
3. 第二條
0. 第三條
8. 第四條
有序列表顯示效果
- 第一條
- 第二條
- 第三條
- 第四條
無(wú)序列表寫法
有3種寫法鳍征,減號(hào)+空格黍翎、加號(hào)+空格、星號(hào)+空格艳丛,空格不能丟匣掸。兩種寫法同時(shí)用的時(shí)候,無(wú)序列表的行距不一樣氮双。
- 鋤禾日當(dāng)午
- 汗滴禾下土
+ 千山鳥飛絕
+ 萬(wàn)徑人蹤滅
* 白毛浮綠水
* 紅掌撥清波
無(wú)序列表顯示效果
- 鋤禾日當(dāng)午
- 汗滴禾下土
- 千山鳥飛絕
- 萬(wàn)徑人蹤滅
- 白毛浮綠水
- 紅掌撥清波
列表嵌套寫法
子列表前加4個(gè)空格碰酝。
1. 有序列表第一個(gè):
- 無(wú)序列表A
1. A 的有序子列表1
1. A 的有序子列表2
- 無(wú)序列表B
2. 有序列表第二個(gè):
列表嵌套顯示效果
- 有序列表第一個(gè):
- 無(wú)序列表A
- A 的有序子列表1
- A 的有序子列表2
- 無(wú)序列表B
- 無(wú)序列表A
- 有序列表第二個(gè):
3. 引用
引用寫法
> 引用內(nèi)容
引用內(nèi)容第二行
> 第三行
>>引用內(nèi)嵌套內(nèi)容
引用顯示效果
引用內(nèi)容
引用內(nèi)容第二行
第三行引用內(nèi)嵌套內(nèi)容
4. 鏈接
鏈接寫法
包含兩種,文字鏈接和網(wǎng)址鏈接眶蕉,鏈接必須添加http:// 砰粹。
[谷歌](http://www.google.com)
<http://www.google.com>或http://www.google.com
鏈接顯示效果
谷歌
http://www.google.com或http://www.google.com
5. 圖片
插入圖片不需要按鈕,只需要使用圖片MD語(yǔ)法即可造挽,等于在文字鏈接前面加一個(gè)感嘆號(hào),方便記憶弄痹。
圖片寫法
圖片名稱可以為空饭入。
![圖片名稱](http://upload-images.jianshu.io/upload_images/11857-31d8162766cd39c8.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)
圖片顯示效果
6. 粗斜體
粗斜體寫法
*我是斜的*
**我是粗的**
***斜加粗***
粗斜體顯示效果
我是斜的
我是粗的
斜加粗
7. 代碼
代碼寫法
使用一個(gè)或三個(gè) ` 將代碼包起來(lái)即可。這個(gè)符號(hào)不是分號(hào)肛真,是Esc鍵下面谐丢,感嘆號(hào)前面的那個(gè)鍵。
`hello,world.`
```
class PostsController < ApplicationController
def index
posts = Post.all
render json: posts
end
end
```
代碼塊顯示效果
hello,world.
class PostsController < ApplicationController
def index
posts = Post.all
render json: posts
end
end
8. 其他語(yǔ)法
換行蚓让、分隔符乾忱、符號(hào)轉(zhuǎn)義、表格
寫法
換行:如果另起一行历极,只需在當(dāng)前行結(jié)尾加 2 個(gè)空格窄瘟,如果是要起一個(gè)新段落,只需要空出一行即可趟卸。
分隔符:新起一行輸入三個(gè)減號(hào)-或星號(hào)*
***
---
* * *
*****
- - -
符號(hào)轉(zhuǎn)義:如果需要用到# * 等符號(hào)蹄葱,但又不想它被轉(zhuǎn)義氏义,可以在這些符號(hào)前加反斜杠,如 \# \* 避免被轉(zhuǎn)義图云。
**加粗加粗** \*\*不想這里的文本被加粗\*\*
表格:一般寫文章不常用惯悠,使用豎線 | 代表表格框線即可。
| A列 | B列 | C列 | D列 |
|--|--|--|--|
| 2 | 3 |2 | 3 |
| 2 | 3 | 2 | 3 |
| 2 | 3 | 2 | 3 |
| 2 | 3 | 2 | 3 |
顯示效果
分隔符
轉(zhuǎn)義字符
加粗加粗 **不想這里的文本被加粗**
表格
A列 | B列 | C列 | D列 |
---|---|---|---|
2 | 3 | 2 | 3 |
2 | 3 | 2 | 3 |
2 | 3 | 2 | 3 |
2 | 3 | 2 | 3 |
二竣况、簡(jiǎn)書編輯器圖片編輯
上傳
直接拖拽到編輯區(qū)域克婶,支持多張圖片同時(shí)上傳。
修改圖片名稱和大小
上傳至簡(jiǎn)書的圖片地址格式為
![圖片名稱](http://…………?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)
圖片鏈接的末尾數(shù)字就是圖片寬度丹泉,通過(guò)這個(gè)數(shù)字可以改變圖片大小情萤。最佳數(shù)字是620。
修改前
![71QDSdukUCL.jpg](http://upload-images.jianshu.io/upload_images/11857-76326f352c2afe1e.jpg?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)
修改后
![蒲公英科學(xué)繪本](http://upload-images.jianshu.io/upload_images/11857-76326f352c2afe1e.jpg?imageMogr2/auto-orient/strip%7CimageView2/2/w/620)
圖片排版
如果有多圖同行排列的需求嘀掸,可以結(jié)合表格語(yǔ)法實(shí)現(xiàn)紫岩。
| 左邊 | 右邊 |
| :--: | :--: |
| ![8801534.jpg](http://upload-images.jianshu.io/upload_images/11857-01cbf3fb27bdff77.jpg?imageMogr2/auto-orient/strip%7CimageView2/2/w/620) | ![蒲公英科學(xué)繪本](http://upload-images.jianshu.io/upload_images/11857-76326f352c2afe1e.jpg?imageMogr2/auto-orient/strip%7CimageView2/2/w/520)|
圖片排版效果
左邊 | 右邊 |
---|---|
三、參考資料
如何切換至 Markdown 編輯器
獻(xiàn)給寫作者的 Markdown 新手指南
Markdown語(yǔ)法說(shuō)明