認識Markdown
Markdown的理念是,能讓文檔更容易讀、寫和隨意改。
使用其他常見的富文本編輯器,您可能需要投入大量的時間編輯排版文稿。使用Markdown來寫作自己的文稿,那么網站的編輯就可以節省大量的時間,不需要耗費精力在調整格式標簽上。而且Markdown 的語法十分簡單。常用的標記符號也不超過十個,Markdown 可謂是十分輕量的,學習成本也不需要太多,且一旦熟悉這種語法規則,會有一勞永逸的效果。
目前Markdown作為一種書寫的格式,現在已經越來越廣泛的流行起來。 markdown語法可以參照下面這個鏈接中的簡明版Markdown中文文檔,下面的文章也會結合我們的具體使用場景,對markdown的主要語法進行介紹。
Markdown常用語法介紹
下面的介紹是根據我們新華地產集團后臺的Markdown編輯器上的標簽從左往右進行介紹。
粗體
Markdown 的粗體非常簡單,用兩個*
包含一段文本就是粗體的語法。
使用方式為點擊編輯器的粗體圖標,在編輯區域出現的四個*
中間輸入你要輸入的文本即可。
例如:**這里是粗體語法**
斜體
Markdown 的斜體的使用方式也非常簡單,用一個*
包含一段文本就是斜體的語法。
使用方式為點擊編輯器的斜體圖標,在編輯區域出現的*
中間輸入你要輸入的文本即可。
例如:*這里是斜體語法*
引用
如果你需要引用一小段別處的句子,那么就要用引用的格式。
例如:> 這里是引用的語法
你只需要在文本前加入 >
這種尖括號(大于號)即可。
如果當你熟悉Markdown語法后,你可以直接在文本編輯區域直接輸入尖括號,而不用點擊引用的圖標,這個時候要注意尖括號要和文字之間加上一個字符的空格,否則引用標簽不會有效果。
無序列表
列表的顯示只需要在文字前加上 -
或*
即可變為無序列表。
無序列表的使用方式是點擊無序列表標簽,在編輯區域出現的*
后面輸入你要輸入的文本即可,如果你使用接下來要說的大屏模式,你可以在使用無序列表時在文字前加 -
號。
例如:
* 無序列表
* 無序列表
* 無序列表
有序列表
有序列表是直接在文字前加 1.
2.
3.
。
有序列表的使用方式是點擊有序列表標簽,在編輯區域出現的數字后面輸入你要輸入的文本即可。
例如:
1. 有序列表
2. 有序列表
3. 有序列表
鏈接
插入鏈接的語法是用 [方括號] 來標記鏈接文字,用(圓括號)標記鏈接地址。
例如:[新華地產集團](http://www.xhhouse.cn/)
圖片
插入圖片與插入鏈接的語法很像,區別在于圖片的方括號前面有一個 !
號。插入圖片的語法是:
- 一個英文輸入狀態下的驚嘆號!
- [方括號]標記圖片的替代文字,[方括號]內可以不寫文字,但[方括號]一定要帶著
- (圓括號)標記圖片地址
例如:
使用文檔和全屏模式
使用文檔就是本文檔的介紹內容。
當你對markdown的基本語法已經比較熟悉的時候,你就可以使用在全屏模式下編寫文本,這樣可以大大提高你的文本編寫速度。
其他可能會使用到的標簽
標題
在我們新華地產集團的后臺中,對新華集團、新華在中國,地產在中國這三個模塊的介紹文字編輯過程中,可能會使用到標題。在 Markdown 中,如果一段文字被定義為標題,只要在這段文字前加 #
號即可。
# 一級標題
## 二級標題
### 三級標題
#### 四級標題
###### 五級標題
###### 六級標題
總共六級標題,使用方式為在編輯器中輸入#
鍵,在#
號后加一個字符的空格,然后輸入標題名稱即可。
表格
姓名 | 生日 | 愛好 |
---|---|---|
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 的基本語法在日常的使用中基本就沒什么大問題了,只要多加練習使用起來肯定會行云流水。