Markdown 語法簡單小結(jié)

[TOC]

寫在前面

最終艘策,我的博客還是回歸到了起點(diǎn)。
博客斷斷續(xù)續(xù)幾年撕贞,盡是折騰界面美化和各種網(wǎng)站框架或者建站工具霎挟,最終,失去了其核心價(jià)值麻掸,即內(nèi)容和思想的沉淀酥夭。這更使得我的博客流于表面,對于自己的成長脊奋,也沒有起到太多正面的作用描睦。

反思后幔烛,決心回歸最簡單的格式外觀嗡贺,將重點(diǎn)集中于高質(zhì)量內(nèi)容的沉淀上赎懦。
這也是為什么又回到了 Markdown 的懷抱。

至于編輯器久又,我用過了眾多純編輯器巫延,眾多 Web 版的富文本編輯器,以及許許多多Markdown 編輯器后地消,決定使用最的 Vim炉峰。同時(shí),也推薦一款 Markdown 編輯器Typora脉执。這款軟件足夠輕量級疼阔,同時(shí)功能做到了盡可能的簡單。至于 Web 編輯器,我使用簡書婆廊。

Markdown 概述

Markdown 是一種輕量級的 “標(biāo)記語言”迅细,創(chuàng)始人為約翰·格魯伯(John Gruber)。它允許人們“使用易讀易寫的純文本格式編寫文檔淘邻,然后轉(zhuǎn)換成有效的XHTML(或者HTML)文檔”茵典。
——Wikipedia

Markdown 擁有這眾多的優(yōu)點(diǎn)

  • 純文本編輯
  • 學(xué)習(xí)成本低
  • 廣泛的軟件支持
  • 在碼農(nóng)界有深厚的基礎(chǔ)

基礎(chǔ)語法

強(qiáng)調(diào)

星號與下劃線都可以,單是斜體宾舅,雙是粗體统阿,符號可跨行,符號可加空格

代碼 效果
*這是斜體* 這是斜體
_這是斜體_ 這是斜體
**這是粗體** 這是粗體
__這是粗體__ 這是粗體

標(biāo)題

代碼:

# 一級標(biāo)題
## 二級標(biāo)題
### 三級標(biāo)題
#### 四級標(biāo)題
##### 五級標(biāo)題
###### 六級標(biāo)題

效果如下:

一級標(biāo)題

二級標(biāo)題

三級標(biāo)題

四級標(biāo)題

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

注意

  1. 最后一個(gè) # 字符與標(biāo)題中間要留有一個(gè)空格
  2. 標(biāo)題共提供 6
  3. 一般行文中贴浙,標(biāo)題應(yīng)置于行首。若置于表格中署恍,可能無法正確解析

引用

Markdown 中引用通過符號 '>' 來實(shí)現(xiàn)崎溃。'>' 符號后的空格,可有可無盯质。
在引用的區(qū)塊內(nèi)袁串,允許換行存在,換行并不會(huì)終止引用的區(qū)塊呼巷。如果要結(jié)束引用囱修,需要一行空白行,來結(jié)束引用的區(qū)塊王悍。

代碼:

> 這是一句引用
> 這句仍然在引用區(qū)塊內(nèi)
>> 這是一句嵌套引用
>> 這句仍然在嵌套引用區(qū)塊內(nèi)
>
> 另起一行的引用破镰。前面需要一個(gè)視覺上的空行表示內(nèi)層嵌套的結(jié)束,空行前面的('>')可以有可以沒有压储。

效果如下:

這是一句引用
這句仍然在引用區(qū)塊內(nèi)

這是一句嵌套引用
這句仍然在嵌套引用區(qū)塊內(nèi)

另起一行的引用鲜漩。前面需要一個(gè)視覺上的空行表示內(nèi)層嵌套的結(jié)束,空行前面的('>')可以有可以沒有集惋。


列表

有序列表

數(shù)字不能省略但可無序孕似,點(diǎn)號之后的空格不能少。
雖然下面代碼的序號是 1刮刑,2喉祭,4,但是在顯示時(shí)雷绢,仍然為自然數(shù)序列泛烙,并不是完成與編號一致。
同樣的翘紊,在列表的最后需要留有一行空行胶惰,以表達(dá)列表的結(jié)束,不然將作為一個(gè)無編號的列表存在霞溪。

代碼:

1. 列表 A
2. 列表 B
4. 列表 C

效果如下:

  1. 列表 A
  2. 列表 B
  3. 列表 C

無序列表

符號之后的空格不能少孵滞,-+*效果一樣中捆,但不能混合使用

代碼:

- 列表 A1
- 列表 B1

+ 列表 A2
+ 列表 B2

* 列表 A3
* 列表 B3

效果如下:

  • 列表 A1
  • 列表 B1
  • 列表 A2
  • 列表 B2
  • 列表 A3
  • 列表 B3

嵌套列表

有序與無序,以及有序和無序列表本身都是可以自由的嵌套的坊饶。
Markdown 中的列表嵌套泄伪,通過在符號前增加空格來表示。同一級別下匿级,前面的空格數(shù)目應(yīng)該保持一致蟋滴。每遞進(jìn)一級,我習(xí)慣上使用 2 個(gè)空格縮進(jìn)來表示痘绎。

代碼:

- 一級列表 A
- 一級列表 B
  - 二級列表 A
  * 二級列表 B
    + 三級列表 A
- 一級列表 C

效果如下:

  • 一級列表 A
  • 一級列表 B
    • 二級列表 A
    • 二級列表 B
      • 三級列表 A
  • 一級列表 C

注意津函,有序列表的嵌套,也是通過預(yù)留空格實(shí)現(xiàn)

  1. 有序一級列表 A
  2. 有序一級列表 B
  3. 有序二級列表 A
  4. 有序二級列表 B
- 無序三級列表 A
- 無序三級列表 B
  1. 有序一級列表 C

分割線

三個(gè)或更多-_*孤页,必須單獨(dú)一行尔苦,可含空格。
例如以下形式行施,都可以表示為分割線允坚。

代碼:

---
- -    -
___
_   __
***
*  **
  *  *  *

進(jìn)階語法

超鏈接

圖片與鏈接,在 Markdown 語法中表達(dá)類似蛾号,都是 [鏈接文字](鏈接地址) 這樣的形式稠项。

普通鏈接

代碼:

[Wikipedia Markdown 條目](https://zh.wikipedia.org/wiki/Markdown)
[Wikipedia Markdown 條目](https://zh.wikipedia.org/wiki/Markdown "Markdown 條目")

效果如下:
Wikipedia Markdown 條目
Wikipedia Markdown 條目

圖片鏈接

圖片需要在 [] 前增加一個(gè) ! 以使得圖片在網(wǎng)頁上直接顯示,而不僅僅是個(gè)鏈接形式鲜结。

代碼:

![維基百科 Logo](https://zh.wikipedia.org/static/images/project-logos/zhwiki.png)
![維基百科 Logo](https://zh.wikipedia.org/static/images/project-logos/zhwiki.png "維基 Logo")

效果如下:


維基百科 Logo
維基百科 Logo

維基百科 Logo
維基百科 Logo

上面分別有兩個(gè)超鏈接和兩張圖片展运,兩個(gè)超鏈接的區(qū)別在于一個(gè)增加了說明注釋,而另一個(gè)沒有精刷,圖片同理乐疆。

索引鏈接

索引鏈接,本質(zhì)上與前兩種鏈接一致贬养,只是索引鏈接將 [鏈接文字](鏈接地址) 分離為[鏈接文字][索引], [索引]:鏈接地址 的形式挤土。

代碼:

[Wikipedia Markdown 條目][1]
[1]:https://zh.wikipedia.org/wiki/Markdown

效果如下:
[Wikipedia Markdown 條目][markdown]
[markdown]:https://zh.wikipedia.org/wiki/Markdown


表格

對于表格的支持,要根據(jù)具體的 Markdown 解釋器來判定误算。在 hexo 中仰美,支持以下 Markdown 形式的表格。
需要注意以下幾點(diǎn):

  1. 表格第一行為標(biāo)題儿礼,樣式會(huì)被特殊處理
  2. | 前后要留有空格
  3. 只要是三個(gè) - 字符表示分隔線
  4. 通過 : 來區(qū)分咖杂,左對齊、居中蚊夫、右對齊

代碼:

| 1 | 2 | 3 |
| --- |:---:| ---:|
| aaa | bbbbbb | c |
| aaaaaa | b | ccc |

效果如下:

1 2 3
aaa bbbbbb c
aaaaaa b ccc

代碼

行內(nèi)代碼

如果要標(biāo)記一小段行內(nèi)代碼诉字,可以用反引號 ` 把它包起來

代碼:

這是一段行內(nèi)代碼,`System.out.println("article id: " + articleId);` 摘自 Redis 工程。

效果如下:

這是一段行內(nèi)代碼壤圃,System.out.println("article id: " + articleId); 摘自 Redis 工程陵霉。

區(qū)塊代碼

如果要成塊的引用代碼,有兩種方法伍绳,一種是用制表符縮進(jìn)踊挠,另一種,則是用三個(gè)反引號 ```冲杀,將代碼塊包起來效床。
在三個(gè)反引號后,加上語言說明权谁,例如 ```java 這樣剩檀,便指定了之后的代碼采用 java 的高亮。

效果如下:

public int genRandPost(int bound) {
    Random rand = new Random();
    int cnt = rand.nextInt(bound);              
    
    Map<String, String> map = new HashMap<String, String>();
                            
    long articleId;
    for (int i = 0; i < cnt; i++) {
        articleId = jedis.incr("article:");
        map.put("author", "author" + i);
        map.put("article", "This is article " + i);
        jedis.hmset("article:" + articleId, map);
        map.clear();
    }
    System.out.println("Insert " + cnt + " posts.");
                                            
    return cnt;
}

公式

大神提供了 hexo 下自動(dòng)部署 MathJax 插件旺芽。安裝好插件后沪猴,遍可以使用 \(LaTex\) 來顯示數(shù)學(xué)公式了。
在行內(nèi)輸入公式甥绿,需要在公式前后加上兩個(gè)反斜杠 '' 以及一個(gè)括號字币,前后兩個(gè)括號要成對则披。
而獨(dú)立成行的公式共缕,則使用兩個(gè)美元符 '$'。

代碼:

在行內(nèi)插入公式 \\(x=\frac{-b\pm\sqrt{b^2-4ac}}{2a}\\) 是這樣的士复。

$$x=\frac{-b\pm\sqrt{b^2-4ac}}{2a}$$

$$
\begin{eqnarray}
\nabla\cdot\vec{E} &=& \frac{\rho}{\epsilon_0} \\
\nabla\cdot\vec{B} &=& 0 \\
\nabla\times\vec{E} &=& -\frac{\partial B}{\partial t} \\
\nabla\times\vec{B} &=& \mu_0\left(\vec{J}+\epsilon_0\frac{\partial E}{\partial t} \right)
\end{eqnarray}
$$

效果如下(簡書下不可用):

在行內(nèi)插入公式 \(x=\frac{-b\pm\sqrt{b^2-4ac}}{2a}\) 是這樣的图谷。

$$x=\frac{-b\pm\sqrt{b^2-4ac}}{2a}$$

$$
\begin{eqnarray}
\nabla\cdot\vec{E} &=& \frac{\rho}{\epsilon_0} \
\nabla\cdot\vec{B} &=& 0 \
\nabla\times\vec{E} &=& -\frac{\partial B}{\partial t} \
\nabla\times\vec{B} &=& \mu_0\left(\vec{J}+\epsilon_0\frac{\partial E}{\partial t} \right)
\end{eqnarray}
$$

參考資料

[1] Wikipedia Markdown 條目,https://zh.wikipedia.org/wiki/Markdown
[2] 不如的博客阱洪,http://ibruce.info/2013/11/26/markdown/
[3] Markdown 語法說明 (簡體中文版)便贵,http://wowubuntu.com/markdown/index.html
[4] Markdown:讓書寫更美好,http://www.reibang.com/p/17fdcf17bbb4
[5] Markdown中插入數(shù)學(xué)公式的方法, http://blog.csdn.net/xiahouzuoxin/article/details/26478179

最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
  • 序言:七十年代末冗荸,一起剝皮案震驚了整個(gè)濱河市承璃,隨后出現(xiàn)的幾起案子,更是在濱河造成了極大的恐慌蚌本,老刑警劉巖盔粹,帶你破解...
    沈念sama閱讀 218,755評論 6 507
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件,死亡現(xiàn)場離奇詭異程癌,居然都是意外死亡舷嗡,警方通過查閱死者的電腦和手機(jī),發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 93,305評論 3 395
  • 文/潘曉璐 我一進(jìn)店門嵌莉,熙熙樓的掌柜王于貴愁眉苦臉地迎上來进萄,“玉大人,你說我怎么就攤上這事≈惺螅” “怎么了可婶?”我有些...
    開封第一講書人閱讀 165,138評論 0 355
  • 文/不壞的土叔 我叫張陵,是天一觀的道長兜蠕。 經(jīng)常有香客問我扰肌,道長,這世上最難降的妖魔是什么熊杨? 我笑而不...
    開封第一講書人閱讀 58,791評論 1 295
  • 正文 為了忘掉前任曙旭,我火速辦了婚禮,結(jié)果婚禮上晶府,老公的妹妹穿的比我還像新娘桂躏。我一直安慰自己,他們只是感情好川陆,可當(dāng)我...
    茶點(diǎn)故事閱讀 67,794評論 6 392
  • 文/花漫 我一把揭開白布剂习。 她就那樣靜靜地躺著,像睡著了一般较沪。 火紅的嫁衣襯著肌膚如雪鳞绕。 梳的紋絲不亂的頭發(fā)上,一...
    開封第一講書人閱讀 51,631評論 1 305
  • 那天尸曼,我揣著相機(jī)與錄音们何,去河邊找鬼。 笑死控轿,一個(gè)胖子當(dāng)著我的面吹牛冤竹,可吹牛的內(nèi)容都是我干的。 我是一名探鬼主播茬射,決...
    沈念sama閱讀 40,362評論 3 418
  • 文/蒼蘭香墨 我猛地睜開眼鹦蠕,長吁一口氣:“原來是場噩夢啊……” “哼!你這毒婦竟也來了在抛?” 一聲冷哼從身側(cè)響起钟病,我...
    開封第一講書人閱讀 39,264評論 0 276
  • 序言:老撾萬榮一對情侶失蹤,失蹤者是張志新(化名)和其女友劉穎刚梭,沒想到半個(gè)月后肠阱,有當(dāng)?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體,經(jīng)...
    沈念sama閱讀 45,724評論 1 315
  • 正文 獨(dú)居荒郊野嶺守林人離奇死亡望浩,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點(diǎn)故事閱讀 37,900評論 3 336
  • 正文 我和宋清朗相戀三年辖所,在試婚紗的時(shí)候發(fā)現(xiàn)自己被綠了。 大學(xué)時(shí)的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片磨德。...
    茶點(diǎn)故事閱讀 40,040評論 1 350
  • 序言:一個(gè)原本活蹦亂跳的男人離奇死亡缘回,死狀恐怖吆视,靈堂內(nèi)的尸體忽然破棺而出,到底是詐尸還是另有隱情酥宴,我是刑警寧澤啦吧,帶...
    沈念sama閱讀 35,742評論 5 346
  • 正文 年R本政府宣布,位于F島的核電站拙寡,受9級特大地震影響授滓,放射性物質(zhì)發(fā)生泄漏。R本人自食惡果不足惜肆糕,卻給世界環(huán)境...
    茶點(diǎn)故事閱讀 41,364評論 3 330
  • 文/蒙蒙 一般堆、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧诚啃,春花似錦淮摔、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 31,944評論 0 22
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至造垛,卻和暖如春魔招,著一層夾襖步出監(jiān)牢的瞬間,已是汗流浹背五辽。 一陣腳步聲響...
    開封第一講書人閱讀 33,060評論 1 270
  • 我被黑心中介騙來泰國打工办斑, 沒想到剛下飛機(jī)就差點(diǎn)兒被人妖公主榨干…… 1. 我叫王不留,地道東北人奔脐。 一個(gè)月前我還...
    沈念sama閱讀 48,247評論 3 371
  • 正文 我出身青樓俄周,卻偏偏與公主長得像吁讨,于是被迫代替她去往敵國和親髓迎。 傳聞我的和親對象是個(gè)殘疾皇子,可洞房花燭夜當(dāng)晚...
    茶點(diǎn)故事閱讀 44,979評論 2 355

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

  • Markdown 語法 之劍 2016.5.3 23:41:46 hljs.initHighlightingOnL...
    光劍書架上的書閱讀 1,633評論 1 5
  • Markdown 語法說明 (簡體中文版) 概述宗旨兼容 HTML特殊字符自動(dòng)轉(zhuǎn)換 區(qū)塊元素段落和換行標(biāo)題區(qū)塊引用...
    蚊子Skeeter閱讀 3,199評論 3 12
  • << 訪問 Wow!Ubuntu NOTE: This is Simplelified Chinese Edit...
    臨城閱讀 6,525評論 4 44
  • 今天還沒下班兒的時(shí)候建丧,兒子就給我打電話說排龄,沒有新的四線方格本兒了,以前的那些都用過了翎朱,老師說要用新的橄维。糾結(jié)著,等著...
    碩寶_202d閱讀 281評論 0 0
  • 長達(dá)兩個(gè)星期拴曲,終于把唐浩明寫的《曾國藩》上卷看完了争舞,對曾國藩的前半生有了大概的認(rèn)識。 從小就聽說過曾國藩的大名澈灼,在...
    常能琿閱讀 1,051評論 0 0