作為一個(gè)程序員,我個(gè)人是非常喜歡用簡書的,因?yàn)楹啎系奈恼麓蟛糠侄加星逦臈l理結(jié)構(gòu)和優(yōu)雅的界面,這對技術(shù)類文章是非常重要的。好了,廢話不說,下面我們就了解一下寫文章時(shí)需要用到的一些markdown語法。讓自己也能寫出界面優(yōu)雅、條理清晰的文章。
0.前置條件
我們要使用帶有markdown特殊格式的文章排版,必須要將基礎(chǔ)設(shè)置里面的常用編輯器設(shè)置為markdown。設(shè)置流程如圖:


一、Markdown語法基礎(chǔ)篇
1. 標(biāo)題
標(biāo)題用1~6個(gè)#號(hào)標(biāo)記,分別代表 一級(jí)~六級(jí)標(biāo)題,多余6個(gè)以上的#自動(dòng)蛻變?yōu)槠胀ㄎ淖帧?br> 語法:
#標(biāo)題名
示例:
# 一級(jí)標(biāo)題
## 二級(jí)標(biāo)題
### 三級(jí)標(biāo)題
#### 四級(jí)標(biāo)題
##### 五級(jí)標(biāo)題
###### 六級(jí)標(biāo)題
####### 哈哈,沒有7級(jí)標(biāo)題哦
效果:

2. 代碼框
作為開發(fā)者,插入代碼框是必須要會(huì)的。代碼框語法為,也就是因英文狀態(tài)下的波浪線(~)那個(gè)按鍵。
語法:
``` 代碼內(nèi)容 ```
示例:
```
override func viewWillAppear(_ animated: Bool) {
super.viewWillAppear(animated)
let configuration = ARWorldTrackingConfiguration()
sceneView.session.run(configuration)
}
```
效果:

3.代碼片
這個(gè)東西跟代碼框其實(shí)差不多,只不過當(dāng)一行的代碼足夠長時(shí),代碼框可以左右滑動(dòng),而代碼片不會(huì),代碼片會(huì)在其包裹的內(nèi)容上蒙上一層淡淡的底色。
語法:
` 代碼塊 `
示例:
`
let gridMaterial = SCNMaterial() gridMaterial.diffuse.contents = UIImage(named: "art.scnassets/grid.png")
plane.materials = [gridMaterial]
`
效果:

4.無序列表
無序列表的實(shí)現(xiàn)方式很簡單,有三種:分別在文字前面加上 * 、- 、+ 中的其中一種即可。注意符號(hào)需要與文字空一個(gè)空格。
語法:
* 文字
- 文字
+ 文字
示例:
* 無序列表1
- 無序列表2
+ 無序列表3
效果:

5.有序列表
有序列表的實(shí)現(xiàn)是 ‘?dāng)?shù)字加點(diǎn)’,后面接上需要描述的文字即可,注意需要要與文字空一個(gè)空格。
語法:
數(shù)字編號(hào). 文字
示例(有序無序列表嵌套):
注意: 如需列表嵌套,上一級(jí)和下一級(jí)之間敲三個(gè)空格即可
1. 一級(jí)有序列表
* 二級(jí)有序列表
效果:

6.引用
我們在寫文章時(shí),有時(shí)需要借鑒、引用他人的文字或論證,這時(shí)引用就變得有必要了。引用語法很簡單,一個(gè) > 符號(hào)就可以。引用可以多層嵌套,每進(jìn)一層,多加一個(gè)>就可以了,可以加很多層。
語法:
> 所引用的內(nèi)容
>> 所引用的內(nèi)容
示例:
>鳳兮鳳兮歸故鄉(xiāng),遨游四海求其凰
>>鳳凰鳴矣,于彼高崗;梧桐生矣,于彼朝陽
>>>大河之劍天上來
效果:

7.強(qiáng)制換行
markdown編輯器下直接回車,預(yù)覽時(shí)換行是顯示不了的。這時(shí)就需要強(qiáng)制換行了。
語法:
<br>
示例:
第一行文字
<br>
第二行文字
效果圖:略
8.轉(zhuǎn)義字符
當(dāng)我門需要直接打印出每個(gè)帶有圖書意義的字符時(shí),就需要一個(gè)轉(zhuǎn)義字符,講那個(gè)特殊字符轉(zhuǎn)換為普通字符,這時(shí)才能打印。比如代碼框符號(hào)```,引用符號(hào)>等。這個(gè)轉(zhuǎn)義字符就是反斜杠 \。
語法:
\需要轉(zhuǎn)義的字符
示例:
\```
\>
\<br>
效果:

9.鏈接
當(dāng)我們的文章有需要跳轉(zhuǎn)其他資源的需求時(shí),此時(shí)就需要一個(gè)鏈接。鏈接的標(biāo)記格式為[需要跳轉(zhuǎn)資源的文字描述](http資源地址),這樣我們點(diǎn)擊文字描述,就能直接跳轉(zhuǎn)到相應(yīng)的資源。
語法:
[需要跳轉(zhuǎn)資源的文字描述](http資源地址)
示例:
你可以在 [簡書](http://www.itdecent.cn/) 上寫出優(yōu)美的文章
效果:

10.插入圖片
插入圖片的語法跟鏈接差不多,多一個(gè)!,標(biāo)記格式為
語法:

示例:

效果:

11. 字體
字體語法可以組合起來使用。
語法:
**加粗**
*傾斜*
_傾斜_
***斜體加粗***
~~加刪除線~~
~~*加刪除線的傾斜*~~
示例:
**這是加粗的文字**
*這是傾斜的文字*
_這是傾斜的文字_
***這是斜體加粗的文字***
~~這是加刪除線的文字~~
~~*這是加刪除線的傾斜文字*~~
效果:

12. 分割線
語法:
三個(gè)或以上的*或-都可以
示例:
***
---
************
------
效果:

二、Markdown語法進(jìn)階篇
1. 上標(biāo)、下標(biāo)
語法一 :
Markdown兼容HTML的語法,所以使用HTML中上下標(biāo)的語法即可。
上標(biāo): <sup>文字</sup>
下標(biāo): <sub>文字</sub>
語法二 :
這種語法有一定兼容性問題,在某些平臺(tái)上可能顯示不出來,比如在掘金上以這種方式實(shí)現(xiàn)的商標(biāo),沒有任何效果,以這種方式實(shí)現(xiàn)的下標(biāo)則變成了刪除線。而這種語法在簡書上的顯示都符合預(yù)期。
上標(biāo): ^文字^
下標(biāo): ~文字~
示例:
水的分子式為:
H<sub>2</sub>O
H~2~O
圓的面積為:
πr<sup>2</sup>
πr^2^
Tencent^這是一個(gè)商標(biāo)TM^
效果:

2. 表格
語法:
第二行分割表頭和內(nèi)容。
- 有一個(gè)就夠了,為了看起來整齊,可以隨意添加。
文字對其方式: 默認(rèn)居左
-兩邊加:表示文字居中
-右邊加:表示文字居右
| 表頭 | 表頭 |
| ------ | ------ |
| 內(nèi)容 | 內(nèi)容 |
| 內(nèi)容 | 內(nèi)容 |
示例:
| 公司 | 坐標(biāo) | 創(chuàng)始人 |
| ------ | ------: | :------: |
| 騰訊 | 深圳 | Pony Ma |
| 阿里 | 杭州 | Jack Ma |
效果:

3. 注釋
所謂注釋,也可以說是草稿,就是不希望顯示出來給別人看到的東西。這樣吐槽、心情和一些不成熟的想法都可以以這種方式記錄。等你時(shí)間充裕,好好整理補(bǔ)充一下這些東西,就可以公開發(fā)表出來了。
注意??: 如果是換行寫的話,前面有四個(gè)空格。
語法:
[^_^]: 需要注釋的內(nèi)容
[>_<]: 需要注釋的內(nèi)容
[>_>]: 需要注釋的內(nèi)容
[·-·]: 需要注釋的內(nèi)容
[@_@]: 需要注釋的內(nèi)容
示例:
[^_^]:
這是草稿,僅作者可見,發(fā)表出來的文章里看不到。
這是草稿
[>_<]: 這是草稿
效果:
略。界面上啥也不會(huì)顯示。
本文尚未提到的語法,基本也是平時(shí)很難用到的語法,有時(shí)間再整理。
未完待續(xù)....