markdown語法從頭講到腳

作為一個程序員,我個人是非常喜歡用簡書的牡属,因為簡書上的文章大部分都有清晰的條理結構和優(yōu)雅的界面吵血,這對技術類文章是非常重要的谎替。好了,廢話不說蹋辅,下面我們就了解一下寫文章時需要用到的一些markdown語法钱贯。讓自己也能寫出界面優(yōu)雅、條理清晰的文章侦另。

0.前置條件

我們要使用帶有markdown特殊格式的文章排版秩命,必須要將基礎設置里面的常用編輯器設置為markdown尉共。設置流程如圖:

image.png
image.png

一、Markdown語法基礎篇

1. 標題

標題用1~6個#號標記硫麻,分別代表 一級~六級標題爸邢,多余6個以上的#自動蛻變?yōu)槠胀ㄎ淖帧?br> 語法

#標題名

示例:

# 一級標題
## 二級標題
### 三級標題
#### 四級標題
##### 五級標題
###### 六級標題
####### 哈哈,沒有7級標題哦

效果

image.png

2. 代碼框

作為開發(fā)者拿愧,插入代碼框是必須要會的。代碼框語法為,也就是因英文狀態(tài)下的波浪線(~)那個按鍵碌尔。
語法

``` 代碼內(nèi)容 ```

示例:
```
override func viewWillAppear(_ animated: Bool) {
super.viewWillAppear(animated)
let configuration = ARWorldTrackingConfiguration()
sceneView.session.run(configuration)
}
```
效果

image.png

3.代碼片

這個東西跟代碼框其實差不多浇辜,只不過當一行的代碼足夠長時,代碼框可以左右滑動唾戚,而代碼片不會柳洋,代碼片會在其包裹的內(nèi)容上蒙上一層淡淡的底色。
語法

` 代碼塊 `

示例:

`
let gridMaterial = SCNMaterial() gridMaterial.diffuse.contents = UIImage(named: "art.scnassets/grid.png") 
plane.materials = [gridMaterial]
`

效果

image.png

4.無序列表

無序列表的實現(xiàn)方式很簡單叹坦,有三種:分別在文字前面加上 * 熊镣、- 、+ 中的其中一種即可募书。注意符號需要與文字空一個空格绪囱。
語法

* 文字
- 文字
+ 文字

示例:

* 無序列表1
- 無序列表2
+ 無序列表3

效果

image.png

5.有序列表

有序列表的實現(xiàn)是 ‘數(shù)字加點’,后面接上需要描述的文字即可莹捡,注意需要要與文字空一個空格鬼吵。
語法

數(shù)字編號. 文字

示例(有序無序列表嵌套):
注意: 如需列表嵌套,上一級和下一級之間敲三個空格即可

1. 一級有序列表
   * 二級有序列表

效果

image.png

6.引用

我們在寫文章時篮赢,有時需要借鑒齿椅、引用他人的文字或論證,這時引用就變得有必要了启泣。引用語法很簡單涣脚,一個 > 符號就可以。引用可以多層嵌套寥茫,每進一層遣蚀,多加一個>就可以了,可以加很多層坠敷。
語法

> 所引用的內(nèi)容
>> 所引用的內(nèi)容

示例:

>鳳兮鳳兮歸故鄉(xiāng)妙同,遨游四海求其凰
>>鳳凰鳴矣,于彼高崗膝迎;梧桐生矣粥帚,于彼朝陽
>>>大河之劍天上來

效果

image.png

7.強制換行

markdown編輯器下直接回車,預覽時換行是顯示不了的限次。這時就需要強制換行了芒涡。
語法

<br>

示例:

第一行文字
<br>
第二行文字

效果圖:略

8.轉義字符

當我門需要直接打印出每個帶有圖書意義的字符時柴灯,就需要一個轉義字符,講那個特殊字符轉換為普通字符费尽,這時才能打印赠群。比如代碼框符號```,引用符號>等旱幼。這個轉義字符就是反斜杠 \查描。
語法

\需要轉義的字符

示例:

\```
\>
\<br>

效果

image.png

9.鏈接

當我們的文章有需要跳轉其他資源的需求時,此時就需要一個鏈接柏卤。鏈接的標記格式為[需要跳轉資源的文字描述](http資源地址)冬三,這樣我們點擊文字描述,就能直接跳轉到相應的資源缘缚。
語法

[需要跳轉資源的文字描述](http資源地址)

示例:

你可以在 [簡書](http://www.reibang.com/) 上寫出優(yōu)美的文章

效果:

image.png

10.插入圖片

插入圖片的語法跟鏈接差不多勾笆,多一個!桥滨,標記格式為![想要顯示的圖片名](圖片地址)
語法

![想要顯示的圖片名](圖片地址)

示例:

![美女小姐姐](http://upload-images.jianshu.io/upload_images/2978034-fd317044c63cd724?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)

效果

image.png

11. 字體

字體語法可以組合起來使用窝爪。
語法:

**加粗**
*傾斜*
_傾斜_
***斜體加粗***
~~加刪除線~~
~~*加刪除線的傾斜*~~

示例:

**這是加粗的文字**
*這是傾斜的文字*
_這是傾斜的文字_
***這是斜體加粗的文字***
~~這是加刪除線的文字~~
~~*這是加刪除線的傾斜文字*~~

效果:

image.png

12. 分割線

語法:

三個或以上的*或-都可以

示例:

***
---
************
------

效果:

image.png

二、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^

效果:

image.png

2. 表格

語法:

第二行分割表頭和內(nèi)容刁品。
- 有一個就夠了泣特,為了看起來整齊,可以隨意添加挑随。
文字對其方式: 默認居左
-兩邊加:表示文字居中
-右邊加:表示文字居右


| 表頭 | 表頭 |
| ------ | ------ |
| 內(nèi)容 | 內(nèi)容 |
| 內(nèi)容 | 內(nèi)容 |

示例:

| 公司 | 坐標 | 創(chuàng)始人 |
| ------ | ------: | :------: |
| 騰訊 | 深圳 | Pony Ma |
| 阿里 | 杭州 | Jack Ma  |

效果:

image.png

3. 注釋

所謂注釋状您,也可以說是草稿,就是不希望顯示出來給別人看到的東西兜挨。這樣吐槽膏孟、心情和一些不成熟的想法都可以以這種方式記錄。等你時間充裕拌汇,好好整理補充一下這些東西柒桑,就可以公開發(fā)表出來了。
注意??: 如果是換行寫的話噪舀,前面有四個空格魁淳。

語法:

[^_^]: 需要注釋的內(nèi)容
[>_<]: 需要注釋的內(nèi)容
[>_>]: 需要注釋的內(nèi)容
[·-·]: 需要注釋的內(nèi)容
[@_@]: 需要注釋的內(nèi)容

示例:

[^_^]:
    這是草稿飘诗,僅作者可見,發(fā)表出來的文章里看不到界逛。
    這是草稿
[>_<]: 這是草稿

效果:
略昆稿。界面上啥也不會顯示。

本文尚未提到的語法息拜,基本也是平時很難用到的語法溉潭,有時間再整理。
未完待續(xù)....

最后編輯于
?著作權歸作者所有,轉載或內(nèi)容合作請聯(lián)系作者
  • 序言:七十年代末少欺,一起剝皮案震驚了整個濱河市岛抄,隨后出現(xiàn)的幾起案子,更是在濱河造成了極大的恐慌狈茉,老刑警劉巖,帶你破解...
    沈念sama閱讀 211,290評論 6 491
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件掸掸,死亡現(xiàn)場離奇詭異氯庆,居然都是意外死亡,警方通過查閱死者的電腦和手機扰付,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 90,107評論 2 385
  • 文/潘曉璐 我一進店門堤撵,熙熙樓的掌柜王于貴愁眉苦臉地迎上來,“玉大人羽莺,你說我怎么就攤上這事实昨。” “怎么了盐固?”我有些...
    開封第一講書人閱讀 156,872評論 0 347
  • 文/不壞的土叔 我叫張陵荒给,是天一觀的道長。 經(jīng)常有香客問我刁卜,道長志电,這世上最難降的妖魔是什么? 我笑而不...
    開封第一講書人閱讀 56,415評論 1 283
  • 正文 為了忘掉前任蛔趴,我火速辦了婚禮挑辆,結果婚禮上,老公的妹妹穿的比我還像新娘孝情。我一直安慰自己鱼蝉,他們只是感情好,可當我...
    茶點故事閱讀 65,453評論 6 385
  • 文/花漫 我一把揭開白布箫荡。 她就那樣靜靜地躺著魁亦,像睡著了一般。 火紅的嫁衣襯著肌膚如雪菲茬。 梳的紋絲不亂的頭發(fā)上吉挣,一...
    開封第一講書人閱讀 49,784評論 1 290
  • 那天派撕,我揣著相機與錄音,去河邊找鬼睬魂。 笑死终吼,一個胖子當著我的面吹牛,可吹牛的內(nèi)容都是我干的氯哮。 我是一名探鬼主播际跪,決...
    沈念sama閱讀 38,927評論 3 406
  • 文/蒼蘭香墨 我猛地睜開眼,長吁一口氣:“原來是場噩夢啊……” “哼喉钢!你這毒婦竟也來了姆打?” 一聲冷哼從身側響起,我...
    開封第一講書人閱讀 37,691評論 0 266
  • 序言:老撾萬榮一對情侶失蹤肠虽,失蹤者是張志新(化名)和其女友劉穎幔戏,沒想到半個月后,有當?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體税课,經(jīng)...
    沈念sama閱讀 44,137評論 1 303
  • 正文 獨居荒郊野嶺守林人離奇死亡闲延,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點故事閱讀 36,472評論 2 326
  • 正文 我和宋清朗相戀三年,在試婚紗的時候發(fā)現(xiàn)自己被綠了韩玩。 大學時的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片垒玲。...
    茶點故事閱讀 38,622評論 1 340
  • 序言:一個原本活蹦亂跳的男人離奇死亡,死狀恐怖找颓,靈堂內(nèi)的尸體忽然破棺而出合愈,到底是詐尸還是另有隱情,我是刑警寧澤击狮,帶...
    沈念sama閱讀 34,289評論 4 329
  • 正文 年R本政府宣布佛析,位于F島的核電站,受9級特大地震影響帘不,放射性物質(zhì)發(fā)生泄漏说莫。R本人自食惡果不足惜,卻給世界環(huán)境...
    茶點故事閱讀 39,887評論 3 312
  • 文/蒙蒙 一寞焙、第九天 我趴在偏房一處隱蔽的房頂上張望储狭。 院中可真熱鬧,春花似錦捣郊、人聲如沸辽狈。這莊子的主人今日做“春日...
    開封第一講書人閱讀 30,741評論 0 21
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽刮萌。三九已至,卻和暖如春娘扩,著一層夾襖步出監(jiān)牢的瞬間着茸,已是汗流浹背壮锻。 一陣腳步聲響...
    開封第一講書人閱讀 31,977評論 1 265
  • 我被黑心中介騙來泰國打工, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留涮阔,地道東北人猜绣。 一個月前我還...
    沈念sama閱讀 46,316評論 2 360
  • 正文 我出身青樓,卻偏偏與公主長得像敬特,于是被迫代替她去往敵國和親掰邢。 傳聞我的和親對象是個殘疾皇子,可洞房花燭夜當晚...
    茶點故事閱讀 43,490評論 2 348

推薦閱讀更多精彩內(nèi)容

  • Android 自定義View的各種姿勢1 Activity的顯示之ViewRootImpl詳解 Activity...
    passiontim閱讀 171,756評論 25 707
  • 關于簡書 Markdown Markdown 語法的目標: 成為一種適用于網(wǎng)絡的書寫語言伟阔。本文的目的:使讀者...
    白老師課堂閱讀 15,413評論 24 177
  • 發(fā)現(xiàn) 關注 消息 iOS 第三方庫辣之、插件、知名博客總結 作者大灰狼的小綿羊哥哥關注 2017.06.26 09:4...
    肇東周閱讀 12,059評論 4 62
  • 第三堂課作業(yè): 第三堂課程結束皱炉,北宸老師讓我們分享一下自己所接觸到或者了解到的關于建筑和科技行業(yè)里面怀估,認為好的一些...
    過后123閱讀 415評論 0 0
  • 轟轟烈烈是假奏夫,平平淡淡才是真。 這是誰說的歪理历筝,讓我作為真理信仰了好多年。如果一場愛情沒有心急火燎的渴望廊谓,沒有一日...
    巴彥閱讀 1,325評論 2 3