作為一個程序員,我個人是非常喜歡用簡書的牡属,因為簡書上的文章大部分都有清晰的條理結構和優(yōu)雅的界面吵血,這對技術類文章是非常重要的谎替。好了,廢話不說蹋辅,下面我們就了解一下寫文章時需要用到的一些markdown語法钱贯。讓自己也能寫出界面優(yōu)雅、條理清晰的文章侦另。
0.前置條件
我們要使用帶有markdown特殊格式的文章排版秩命,必須要將基礎設置里面的常用編輯器設置為markdown尉共。設置流程如圖:
一、Markdown語法基礎篇
1. 標題
標題用1~6個#號標記硫麻,分別代表 一級~六級標題爸邢,多余6個以上的#自動蛻變?yōu)槠胀ㄎ淖帧?br> 語法:
#標題名
示例:
# 一級標題
## 二級標題
### 三級標題
#### 四級標題
##### 五級標題
###### 六級標題
####### 哈哈,沒有7級標題哦
效果:
2. 代碼框
作為開發(fā)者拿愧,插入代碼框是必須要會的。代碼框語法為,也就是因英文狀態(tài)下的波浪線(~)那個按鍵碌尔。
語法:
``` 代碼內(nèi)容 ```
示例:
```
override func viewWillAppear(_ animated: Bool) {
super.viewWillAppear(animated)
let configuration = ARWorldTrackingConfiguration()
sceneView.session.run(configuration)
}
```
效果:
3.代碼片
這個東西跟代碼框其實差不多浇辜,只不過當一行的代碼足夠長時,代碼框可以左右滑動唾戚,而代碼片不會柳洋,代碼片會在其包裹的內(nèi)容上蒙上一層淡淡的底色。
語法:
` 代碼塊 `
示例:
`
let gridMaterial = SCNMaterial() gridMaterial.diffuse.contents = UIImage(named: "art.scnassets/grid.png")
plane.materials = [gridMaterial]
`
效果:
4.無序列表
無序列表的實現(xiàn)方式很簡單叹坦,有三種:分別在文字前面加上 * 熊镣、- 、+ 中的其中一種即可募书。注意符號需要與文字空一個空格绪囱。
語法:
* 文字
- 文字
+ 文字
示例:
* 無序列表1
- 無序列表2
+ 無序列表3
效果:
5.有序列表
有序列表的實現(xiàn)是 ‘數(shù)字加點’,后面接上需要描述的文字即可莹捡,注意需要要與文字空一個空格鬼吵。
語法:
數(shù)字編號. 文字
示例(有序無序列表嵌套):
注意: 如需列表嵌套,上一級和下一級之間敲三個空格即可
1. 一級有序列表
* 二級有序列表
效果:
6.引用
我們在寫文章時篮赢,有時需要借鑒齿椅、引用他人的文字或論證,這時引用就變得有必要了启泣。引用語法很簡單涣脚,一個 > 符號就可以。引用可以多層嵌套寥茫,每進一層遣蚀,多加一個>就可以了,可以加很多層坠敷。
語法:
> 所引用的內(nèi)容
>> 所引用的內(nèi)容
示例:
>鳳兮鳳兮歸故鄉(xiāng)妙同,遨游四海求其凰
>>鳳凰鳴矣,于彼高崗膝迎;梧桐生矣粥帚,于彼朝陽
>>>大河之劍天上來
效果:
7.強制換行
markdown編輯器下直接回車,預覽時換行是顯示不了的限次。這時就需要強制換行了芒涡。
語法:
<br>
示例:
第一行文字
<br>
第二行文字
效果圖:略
8.轉義字符
當我門需要直接打印出每個帶有圖書意義的字符時柴灯,就需要一個轉義字符,講那個特殊字符轉換為普通字符费尽,這時才能打印赠群。比如代碼框符號```,引用符號>等旱幼。這個轉義字符就是反斜杠 \查描。
語法:
\需要轉義的字符
示例:
\```
\>
\<br>
效果:
9.鏈接
當我們的文章有需要跳轉其他資源的需求時,此時就需要一個鏈接柏卤。鏈接的標記格式為[需要跳轉資源的文字描述
](http資源地址
)冬三,這樣我們點擊文字描述,就能直接跳轉到相應的資源缘缚。
語法:
[需要跳轉資源的文字描述](http資源地址)
示例:
你可以在 [簡書](http://www.reibang.com/) 上寫出優(yōu)美的文章
效果:
10.插入圖片
插入圖片的語法跟鏈接差不多勾笆,多一個!桥滨,標記格式為![想要顯示的圖片名
](圖片地址
)
語法:
![想要顯示的圖片名](圖片地址)
示例:
![美女小姐姐](http://upload-images.jianshu.io/upload_images/2978034-fd317044c63cd724?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)
效果:
11. 字體
字體語法可以組合起來使用窝爪。
語法:
**加粗**
*傾斜*
_傾斜_
***斜體加粗***
~~加刪除線~~
~~*加刪除線的傾斜*~~
示例:
**這是加粗的文字**
*這是傾斜的文字*
_這是傾斜的文字_
***這是斜體加粗的文字***
~~這是加刪除線的文字~~
~~*這是加刪除線的傾斜文字*~~
效果:
12. 分割線
語法:
三個或以上的*或-都可以
示例:
***
---
************
------
效果:
二、Markdown語法進階篇
1. 上標齐媒、下標
語法一 :
Markdown兼容HTML的語法蒲每,所以使用HTML中上下標的語法即可。
上標: <sup>文字</sup>
下標: <sub>文字</sub>
語法二 :
這種語法有一定兼容性問題里初,在某些平臺上可能顯示不出來啃勉,比如在掘金上以這種方式實現(xiàn)的商標,沒有任何效果双妨,以這種方式實現(xiàn)的下標則變成了刪除線淮阐。而這種語法在簡書上的顯示都符合預期。
上標: ^文字^
下標: ~文字~
示例:
水的分子式為:
H<sub>2</sub>O
H~2~O
圓的面積為:
πr<sup>2</sup>
πr^2^
Tencent^這是一個商標TM^
效果:
2. 表格
語法:
第二行分割表頭和內(nèi)容刁品。
- 有一個就夠了泣特,為了看起來整齊,可以隨意添加挑随。
文字對其方式: 默認居左
-兩邊加:表示文字居中
-右邊加:表示文字居右
| 表頭 | 表頭 |
| ------ | ------ |
| 內(nèi)容 | 內(nèi)容 |
| 內(nèi)容 | 內(nèi)容 |
示例:
| 公司 | 坐標 | 創(chuàng)始人 |
| ------ | ------: | :------: |
| 騰訊 | 深圳 | Pony Ma |
| 阿里 | 杭州 | Jack Ma |
效果:
3. 注釋
所謂注釋状您,也可以說是草稿,就是不希望顯示出來給別人看到的東西兜挨。這樣吐槽膏孟、心情和一些不成熟的想法都可以以這種方式記錄。等你時間充裕拌汇,好好整理補充一下這些東西柒桑,就可以公開發(fā)表出來了。
注意??: 如果是換行寫的話噪舀,前面有四個空格魁淳。
語法:
[^_^]: 需要注釋的內(nèi)容
[>_<]: 需要注釋的內(nèi)容
[>_>]: 需要注釋的內(nèi)容
[·-·]: 需要注釋的內(nèi)容
[@_@]: 需要注釋的內(nèi)容
示例:
[^_^]:
這是草稿飘诗,僅作者可見,發(fā)表出來的文章里看不到界逛。
這是草稿
[>_<]: 這是草稿
效果:
略昆稿。界面上啥也不會顯示。
本文尚未提到的語法息拜,基本也是平時很難用到的語法溉潭,有時間再整理。
未完待續(xù)....