markdown使用說明

認(rèn)識Markdown

Markdown的理念是,能讓文檔更容易讀、寫和隨意改。
使用其他常見的富文本編輯器,您可能需要投入大量的時間編輯排版文稿。使用Markdown來寫作自己的文稿,那么網(wǎng)站的編輯就可以節(jié)省大量的時間,不需要耗費(fèi)精力在調(diào)整格式標(biāo)簽上。而且Markdown 的語法十分簡單。常用的標(biāo)記符號也不超過十個,Markdown 可謂是十分輕量的,學(xué)習(xí)成本也不需要太多,且一旦熟悉這種語法規(guī)則,會有一勞永逸的效果。
目前Markdown作為一種書寫的格式,現(xiàn)在已經(jīng)越來越廣泛的流行起來。 markdown語法可以參照下面這個鏈接中的簡明版Markdown中文文檔,下面的文章也會結(jié)合我們的具體使用場景,對markdown的主要語法進(jìn)行介紹。

Markdown常用語法介紹

下面的介紹是根據(jù)我們新華地產(chǎn)集團(tuán)后臺的Markdown編輯器上的標(biāo)簽從左往右進(jìn)行介紹。

粗體

Markdown 的粗體非常簡單,用兩個*包含一段文本就是粗體的語法。
使用方式為點擊編輯器的粗體圖標(biāo),在編輯區(qū)域出現(xiàn)的四個*中間輸入你要輸入的文本即可。
例如:**這里是粗體語法**

43EF.tmp.jpg

斜體

Markdown 的斜體的使用方式也非常簡單,用一個*包含一段文本就是斜體的語法。
使用方式為點擊編輯器的斜體圖標(biāo),在編輯區(qū)域出現(xiàn)的*中間輸入你要輸入的文本即可。
例如:*這里是斜體語法*

3D55.tmp.jpg

引用

如果你需要引用一小段別處的句子,那么就要用引用的格式。
例如:> 這里是引用的語法

450.tmp.jpg

你只需要在文本前加入 >這種尖括號(大于號)即可。
如果當(dāng)你熟悉Markdown語法后,你可以直接在文本編輯區(qū)域直接輸入尖括號,而不用點擊引用的圖標(biāo),這個時候要注意尖括號要和文字之間加上一個字符的空格,否則引用標(biāo)簽不會有效果。

無序列表

列表的顯示只需要在文字前加上 -*即可變?yōu)闊o序列表。
無序列表的使用方式是點擊無序列表標(biāo)簽,在編輯區(qū)域出現(xiàn)的*后面輸入你要輸入的文本即可,如果你使用接下來要說的大屏模式,你可以在使用無序列表時在文字前加 -號。
例如:
* 無序列表
* 無序列表
* 無序列表

C8DF.tmp.jpg

有序列表

有序列表是直接在文字前加 1. 2. 3.
有序列表的使用方式是點擊有序列表標(biāo)簽,在編輯區(qū)域出現(xiàn)的數(shù)字后面輸入你要輸入的文本即可。

例如:

1. 有序列表
2. 有序列表
3. 有序列表

750C.tmp.jpg

鏈接

插入鏈接的語法是用 [方括號] 來標(biāo)記鏈接文字,用(圓括號)標(biāo)記鏈接地址。
例如:[新華地產(chǎn)集團(tuán)](http://www.xhhouse.cn/)

圖片

插入圖片與插入鏈接的語法很像,區(qū)別在于圖片的方括號前面有一個 !號。插入圖片的語法是:

  • 一個英文輸入狀態(tài)下的驚嘆號!
  • [方括號]標(biāo)記圖片的替代文字,[方括號]內(nèi)可以不寫文字,但[方括號]一定要帶著
  • (圓括號)標(biāo)記圖片地址

例如:![新華學(xué)府花園](http://upload-images.jianshu.io/upload_images/2580611-b8bfdbd573c953d1.jpg?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)

新華學(xué)府花園

使用文檔和全屏模式

使用文檔就是本文檔的介紹內(nèi)容。
當(dāng)你對markdown的基本語法已經(jīng)比較熟悉的時候,你就可以使用在全屏模式下編寫文本,這樣可以大大提高你的文本編寫速度。

其他可能會使用到的標(biāo)簽

標(biāo)題

在我們新華地產(chǎn)集團(tuán)的后臺中,對新華集團(tuán)、新華在中國,地產(chǎn)在中國這三個模塊的介紹文字編輯過程中,可能會使用到標(biāo)題。在 Markdown 中,如果一段文字被定義為標(biāo)題,只要在這段文字前加 #號即可。

# 一級標(biāo)題

## 二級標(biāo)題

### 三級標(biāo)題

#### 四級標(biāo)題

###### 五級標(biāo)題

###### 六級標(biāo)題

總共六級標(biāo)題,使用方式為在編輯器中輸入#鍵,在#號后加一個字符的空格,然后輸入標(biāo)題名稱即可。

25A9.tmp.jpg

表格

姓名 生日 愛好
koma 1962年6月10日 guitar
ailing 1920年09月30日 writer
echo 1943年3月26日 writer

表格例子如下:
`

姓名 生日 愛好
koma 1962年6月10日 guitar
ailing 1920年09月30日 writer
echo 1943年3月26日 writer

`

這種語法生成的表格如下:

姓名 生日 愛好
koma 1962年6月10日 guitar
ailing 1920年09月30日 writer
echo 1943年3月26日 writer

常見問題

換行問題

Markdown對換行的語法規(guī)范是空格+空格+回車換行,也就是說,如果你要進(jìn)行換行操作,你需要先按兩次空格鍵,然后按一次回車鍵即可。

分段落問題

Markdown對分段的語法規(guī)范是按兩次回車鍵,也就是說,如果你要進(jìn)行分段操作,你只需要按兩次回車鍵即可。當(dāng)然,多次使用回車鍵的效果與按兩次回車鍵的效果一樣,并不會產(chǎn)生多余的空白行。

標(biāo)簽規(guī)范使用問題

規(guī)范的Markdown語法是,使用的標(biāo)簽和后面的文本要有一個字符的空格,否則可能在后臺預(yù)覽正常,但是前臺卻不會正常顯示。

小結(jié)

熟悉以上這些Markdown的語法后,Markdown 的基本語法在日常的使用中基本就沒什么大問題了,只要多加練習(xí)使用起來肯定會行云流水。

最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
平臺聲明:文章內(nèi)容(如有圖片或視頻亦包括在內(nèi))由作者上傳并發(fā)布,文章內(nèi)容僅代表作者本人觀點,簡書系信息發(fā)布平臺,僅提供信息存儲服務(wù)。

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