markdown語法從頭講到腳

作為一個(gè)程序員,我個(gè)人是非常喜歡用簡書的,因?yàn)楹啎系奈恼麓蟛糠侄加星逦臈l理結(jié)構(gòu)和優(yōu)雅的界面,這對技術(shù)類文章是非常重要的。好了,廢話不說,下面我們就了解一下寫文章時(shí)需要用到的一些markdown語法。讓自己也能寫出界面優(yōu)雅、條理清晰的文章。

0.前置條件

我們要使用帶有markdown特殊格式的文章排版,必須要將基礎(chǔ)設(shè)置里面的常用編輯器設(shè)置為markdown。設(shè)置流程如圖:

image.png
image.png

一、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)題哦

效果

image.png

2. 代碼框

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

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

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

image.png

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]
`

效果

image.png

4.無序列表

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

* 文字
- 文字
+ 文字

示例:

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

效果

image.png

5.有序列表

有序列表的實(shí)現(xiàn)是 ‘?dāng)?shù)字加點(diǎn)’,后面接上需要描述的文字即可,注意需要要與文字空一個(gè)空格。
語法

數(shù)字編號(hào). 文字

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

1. 一級(jí)有序列表
   * 二級(jí)有序列表

效果

image.png

6.引用

我們在寫文章時(shí),有時(shí)需要借鑒、引用他人的文字或論證,這時(shí)引用就變得有必要了。引用語法很簡單,一個(gè) > 符號(hào)就可以。引用可以多層嵌套,每進(jìn)一層,多加一個(gè)>就可以了,可以加很多層。
語法

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

示例:

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

效果

image.png

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>

效果

image.png

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)美的文章

效果:

image.png

10.插入圖片

插入圖片的語法跟鏈接差不多,多一個(gè)!,標(biāo)記格式為![想要顯示的圖片名](圖片地址)
語法

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

示例:

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

效果

image.png

11. 字體

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

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

示例:

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

效果:

image.png

12. 分割線

語法:

三個(gè)或以上的*或-都可以

示例:

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

效果:

image.png

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

效果:

image.png

2. 表格

語法:

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


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

示例:

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

效果:

image.png

3. 注釋

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

語法:

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

示例:

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

效果:
略。界面上啥也不會(huì)顯示。

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

最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
【社區(qū)內(nèi)容提示】社區(qū)部分內(nèi)容疑似由AI輔助生成,瀏覽時(shí)請結(jié)合常識(shí)與多方信息審慎甄別。
平臺(tái)聲明:文章內(nèi)容(如有圖片或視頻亦包括在內(nèi))由作者上傳并發(fā)布,文章內(nèi)容僅代表作者本人觀點(diǎn),簡書系信息發(fā)布平臺(tái),僅提供信息存儲(chǔ)服務(wù)。

相關(guān)閱讀更多精彩內(nèi)容

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

友情鏈接更多精彩內(nèi)容