markdown使用說明

認識Markdown

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

Markdown常用語法介紹

下面的介紹是根據我們新華地產集團后臺的Markdown編輯器上的標簽從左往右進行介紹。

粗體

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

43EF.tmp.jpg

斜體

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

3D55.tmp.jpg

引用

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

450.tmp.jpg

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

無序列表

列表的顯示只需要在文字前加上 -*即可變為無序列表。
無序列表的使用方式是點擊無序列表標簽,在編輯區域出現的*后面輸入你要輸入的文本即可,如果你使用接下來要說的大屏模式,你可以在使用無序列表時在文字前加 -號。
例如:
* 無序列表
* 無序列表
* 無序列表

C8DF.tmp.jpg

有序列表

有序列表是直接在文字前加 1. 2. 3.
有序列表的使用方式是點擊有序列表標簽,在編輯區域出現的數字后面輸入你要輸入的文本即可。

例如:

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

750C.tmp.jpg

鏈接

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

圖片

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

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

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

新華學府花園

使用文檔和全屏模式

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

其他可能會使用到的標簽

標題

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

# 一級標題

## 二級標題

### 三級標題

#### 四級標題

###### 五級標題

###### 六級標題

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

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對換行的語法規范是空格+空格+回車換行,也就是說,如果你要進行換行操作,你需要先按兩次空格鍵,然后按一次回車鍵即可。

分段落問題

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

標簽規范使用問題

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

小結

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

最后編輯于
?著作權歸作者所有,轉載或內容合作請聯系作者
平臺聲明:文章內容(如有圖片或視頻亦包括在內)由作者上傳并發布,文章內容僅代表作者本人觀點,簡書系信息發布平臺,僅提供信息存儲服務。
  • 序言:七十年代末,一起剝皮案震驚了整個濱河市,隨后出現的幾起案子,更是在濱河造成了極大的恐慌,老刑警劉巖,帶你破解...
    沈念sama閱讀 228,739評論 6 534
  • 序言:濱河連續發生了三起死亡事件,死亡現場離奇詭異,居然都是意外死亡,警方通過查閱死者的電腦和手機,發現死者居然都...
    沈念sama閱讀 98,634評論 3 419
  • 文/潘曉璐 我一進店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來,“玉大人,你說我怎么就攤上這事。” “怎么了?”我有些...
    開封第一講書人閱讀 176,653評論 0 377
  • 文/不壞的土叔 我叫張陵,是天一觀的道長。 經常有香客問我,道長,這世上最難降的妖魔是什么? 我笑而不...
    開封第一講書人閱讀 63,063評論 1 314
  • 正文 為了忘掉前任,我火速辦了婚禮,結果婚禮上,老公的妹妹穿的比我還像新娘。我一直安慰自己,他們只是感情好,可當我...
    茶點故事閱讀 71,835評論 6 410
  • 文/花漫 我一把揭開白布。 她就那樣靜靜地躺著,像睡著了一般。 火紅的嫁衣襯著肌膚如雪。 梳的紋絲不亂的頭發上,一...
    開封第一講書人閱讀 55,235評論 1 324
  • 那天,我揣著相機與錄音,去河邊找鬼。 笑死,一個胖子當著我的面吹牛,可吹牛的內容都是我干的。 我是一名探鬼主播,決...
    沈念sama閱讀 43,315評論 3 442
  • 文/蒼蘭香墨 我猛地睜開眼,長吁一口氣:“原來是場噩夢啊……” “哼!你這毒婦竟也來了?” 一聲冷哼從身側響起,我...
    開封第一講書人閱讀 42,459評論 0 289
  • 序言:老撾萬榮一對情侶失蹤,失蹤者是張志新(化名)和其女友劉穎,沒想到半個月后,有當地人在樹林里發現了一具尸體,經...
    沈念sama閱讀 49,000評論 1 335
  • 正文 獨居荒郊野嶺守林人離奇死亡,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內容為張勛視角 年9月15日...
    茶點故事閱讀 40,819評論 3 355
  • 正文 我和宋清朗相戀三年,在試婚紗的時候發現自己被綠了。 大學時的朋友給我發了我未婚夫和他白月光在一起吃飯的照片。...
    茶點故事閱讀 43,004評論 1 370
  • 序言:一個原本活蹦亂跳的男人離奇死亡,死狀恐怖,靈堂內的尸體忽然破棺而出,到底是詐尸還是另有隱情,我是刑警寧澤,帶...
    沈念sama閱讀 38,560評論 5 362
  • 正文 年R本政府宣布,位于F島的核電站,受9級特大地震影響,放射性物質發生泄漏。R本人自食惡果不足惜,卻給世界環境...
    茶點故事閱讀 44,257評論 3 347
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧,春花似錦、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 34,676評論 0 26
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至,卻和暖如春,著一層夾襖步出監牢的瞬間,已是汗流浹背。 一陣腳步聲響...
    開封第一講書人閱讀 35,937評論 1 288
  • 我被黑心中介騙來泰國打工, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留,地道東北人。 一個月前我還...
    沈念sama閱讀 51,717評論 3 393
  • 正文 我出身青樓,卻偏偏與公主長得像,于是被迫代替她去往敵國和親。 傳聞我的和親對象是個殘疾皇子,可洞房花燭夜當晚...
    茶點故事閱讀 48,003評論 2 374

推薦閱讀更多精彩內容