MarkDown基礎(chǔ)語法

"https://en.wikipedia.org/wiki/Markdown#Example

區(qū)塊元素

段落和換行

一個(gè) Markdown 段落是由一個(gè)或多個(gè)連續(xù)的文本行組成嚣鄙,它的前后要有一個(gè)以上的空行。普通段落不該用空格或制表符來縮進(jìn)七问。

標(biāo)題

Markdown 支持兩種標(biāo)題的語法骗露,類 Setext 和類 atx 形式抡诞。
類 Setext 形式是用底線的形式症见,利用 =(最高階標(biāo)題)和 -(第二階標(biāo)題)阅束,例如:
This is an H1
=============
This is an H2
-------------

任何數(shù)量的=和-都有效
類 Atx 形式則是在行首插入 1 到 6 個(gè) #,對(duì)應(yīng)到標(biāo)題 1 到 6 階躬存,例如:
# This is an H1
## This is an H2
###### This is an H3

區(qū)塊引用 Blockquotes

Markdown 標(biāo)記區(qū)塊引用是使用類似 email 中用 >的引用方式。如果你還熟悉在 email 信件中的引言部分舀锨,你就知道怎么Markdown 文件中建立一個(gè)區(qū)塊引用岭洲,那會(huì)看起來像是你自己先斷好行,然后在每行的最前面加上 >:
> This is a blockquote with two paragraphs. Lorem ipsum dolor sit amet,
> consectetuer adipiscing elit. Aliquam hendrerit mi posuere lectus.
> Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, risus.
>
> Donec sit amet nisl. Aliquam semper ipsum sit amet velit. Suspendisse
> id sem consectetuer libero luctus adipiscing.

Markdown 也允許你偷懶只在整個(gè)段落的第一行最前面加上 >:
> This is a blockquote with two paragraphs. Lorem ipsum dolor sit amet,consectetuer adipiscing elit. Aliquam hendrerit mi posuere lectus.Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, risus.
> Donec sit amet nisl. Aliquam semper ipsum sit amet velit. Suspendisseid sem consectetuer libero luctus adipiscing.

區(qū)塊引用可以嵌套(例如:引用內(nèi)的引用)坎匿,只要根據(jù)層次加上不同數(shù)量的 >:
> This is the first level of quoting.
>
>> This is nested blockquote.
>> Back to the first level.

引用的區(qū)塊內(nèi)也可以使用其他的 Markdown 語法盾剩,包括標(biāo)題、列表替蔬、代碼區(qū)塊等:
> ## 這是一個(gè)標(biāo)題告私。
>
> 1. 這是第一行列表項(xiàng)。
> 2. 這是第二行列表項(xiàng)承桥。
> > 給出一些例子代碼:
>
> return shell_exec("echo $input | $markdown_script");

列表

無序列表使用星號(hào)驻粟、加號(hào)或是減號(hào)作為列表標(biāo)記:
* Red
* Green
* Blue
或者:
+ Red
+ Green
+ Blue
或者
- Red
- Green
- Blue

有序列表則使用數(shù)字接著一個(gè)英文句點(diǎn):
1. Red
2. Green
3. Blue

如果要放代碼區(qū)塊的話,該區(qū)塊就需要縮進(jìn)兩次凶异,也就是 8 個(gè)空格或是 2 個(gè)制表符:
* 一列表項(xiàng)包含一個(gè)列表區(qū)塊:
\tab\tab<代碼寫在這>

如果在行首出現(xiàn)數(shù)字-句點(diǎn)-空白蜀撑,你可以在句點(diǎn)前面加上反斜杠:

1986\. What a great season.

代碼區(qū)塊

建立代碼區(qū)塊很簡單,只要簡單地縮進(jìn) 4 個(gè)空格或是 1 個(gè)制表符就可以剩彬,例如酷麦,下面的輸入:

這是一個(gè)普通段落:
 
     這是一個(gè)代碼區(qū)塊。

在代碼區(qū)塊里面喉恋, &沃饶、 <和 >會(huì)自動(dòng)轉(zhuǎn)成 HTML 實(shí)體,這樣的方式讓你非常容易使用 Markdown 插入范例用的 HTML 原始碼轻黑,只需要復(fù)制貼上糊肤,再加上縮進(jìn)就可以了,剩下的 Markdown 都會(huì)幫你處理苔悦,例如:

<div class="footer">
     ? 2004 Foo Corporation 
</div>

分隔線

你可以在一行中用三個(gè)以上的星號(hào)轩褐、減號(hào)、底線來建立一個(gè)分隔線:
***

---

----------

區(qū)段元素

鏈接

Markdown 支持兩種形式的鏈接語法: 行內(nèi)式參考式兩種形式玖详。
不管是哪一種把介,鏈接文字都是用 [方括號(hào)] 來標(biāo)記勤讽。
要建立一個(gè)行內(nèi)式的鏈接,只要在方塊括號(hào)后面緊接著圓括號(hào)并插入網(wǎng)址鏈接即可拗踢,如果你還想要加上鏈接的 title 文字脚牍,只要在網(wǎng)址后面,用雙引號(hào)把 title 文字包起來即可巢墅,例如:

This is [an example](http://example.com/ "Title") inline link.
[This link](http://example.net/) has no title attribute.

參考式的鏈接是在鏈接文字的括號(hào)后面再接上另一個(gè)方括號(hào)诸狭,而在第二個(gè)方括號(hào)里面要填入用以辨識(shí)鏈接的標(biāo)記:

This is [an example][id] reference-style link.

接著,在文件的任意處君纫,你可以把這個(gè)標(biāo)記的鏈接內(nèi)容定義出來:
[id]: http://example.com/ "Optional Title Here"

隱式鏈接標(biāo)記功能讓你可以省略指定鏈接標(biāo)記驯遇,這種情形下,鏈接標(biāo)記會(huì)視為等同于鏈接文字蓄髓,要用隱式鏈接標(biāo)記只要在鏈接文字后面加上一個(gè)空的方括號(hào)叉庐,如果你要讓 "Google" 鏈接到 google.com,你可以簡化成:

[Google][]

然后定義鏈接內(nèi)容:
[Google]: http://google.com/

鏈接的定義可以放在文件中的任何一個(gè)地方会喝,我比較偏好直接放在鏈接出現(xiàn)段落的后面陡叠,你也可以把它放在文件最后面,就像是注解一樣肢执。

下面是一個(gè)參考式鏈接的范例:

I get 10 times more traffic from [Google] [1] than from[Yahoo] [2] or [MSN] [3].

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

Markdown 使用星號(hào)(*)和底線(_)作為標(biāo)記強(qiáng)調(diào)字詞的符號(hào)

*single asterisks*

_single underscores_

**double asterisks**

__double underscores__

*** Other ***

代碼

如果要標(biāo)記一小段行內(nèi)代碼枉阵,你可以用反引號(hào)把它包起來(`),例如:

Use the `printf()` function.

如果要在代碼區(qū)段內(nèi)插入反引號(hào)预茄,你可以用多個(gè)反引號(hào)來開啟和結(jié)束代碼區(qū)段:

``There is a literal backtick (`) here.``

圖片

行內(nèi)式的圖片語法看起來像是:

![毛杰](/Users/mao/Downloads/mao/520.jpg)
![毛杰](/Users/mao/Downloads/mao/520.jpg "Optional title")

參考式的圖片語法則長得像這樣:

![Alt text][id]

「id」是圖片參考的名稱兴溜,圖片參考的定義方式則和鏈接參考一樣:

[id]: url/to/image "Optional title attribute"

到目前為止, Markdown 還沒有辦法指定圖片的寬高反璃,如果你需要的話昵慌,你可以使用普通的<img>標(biāo)簽


其它

Markdown 支持以比較簡短的自動(dòng)鏈接形式來處理網(wǎng)址和電子郵件信箱,只要是用方括號(hào)包起來淮蜈, Markdown 就會(huì)自動(dòng)把它轉(zhuǎn)成鏈接斋攀。一般網(wǎng)址的鏈接文字就和鏈接地址一樣,例如:
http://example.com/

address@example.com

Markdown 支持以下這些符號(hào)前面加上反斜杠來幫助插入普通的符號(hào):

\ 反斜線
` 反引號(hào)
* 星號(hào)
_ 底線
{} 花括號(hào)
[] 方括號(hào)
() 括弧
# 井字號(hào)
+ 加號(hào)
- 減號(hào)
. 英文句點(diǎn)
! 驚嘆號(hào)
最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
  • 序言:七十年代末梧田,一起剝皮案震驚了整個(gè)濱河市淳蔼,隨后出現(xiàn)的幾起案子,更是在濱河造成了極大的恐慌裁眯,老刑警劉巖鹉梨,帶你破解...
    沈念sama閱讀 210,914評(píng)論 6 490
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件,死亡現(xiàn)場離奇詭異穿稳,居然都是意外死亡存皂,警方通過查閱死者的電腦和手機(jī),發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 89,935評(píng)論 2 383
  • 文/潘曉璐 我一進(jìn)店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來旦袋,“玉大人骤菠,你說我怎么就攤上這事“淘校” “怎么了商乎?”我有些...
    開封第一講書人閱讀 156,531評(píng)論 0 345
  • 文/不壞的土叔 我叫張陵,是天一觀的道長祭阀。 經(jīng)常有香客問我鹉戚,道長,這世上最難降的妖魔是什么专控? 我笑而不...
    開封第一講書人閱讀 56,309評(píng)論 1 282
  • 正文 為了忘掉前任抹凳,我火速辦了婚禮,結(jié)果婚禮上伦腐,老公的妹妹穿的比我還像新娘却桶。我一直安慰自己,他們只是感情好蔗牡,可當(dāng)我...
    茶點(diǎn)故事閱讀 65,381評(píng)論 5 384
  • 文/花漫 我一把揭開白布。 她就那樣靜靜地躺著嗅剖,像睡著了一般辩越。 火紅的嫁衣襯著肌膚如雪。 梳的紋絲不亂的頭發(fā)上信粮,一...
    開封第一講書人閱讀 49,730評(píng)論 1 289
  • 那天黔攒,我揣著相機(jī)與錄音,去河邊找鬼强缘。 笑死督惰,一個(gè)胖子當(dāng)著我的面吹牛,可吹牛的內(nèi)容都是我干的旅掂。 我是一名探鬼主播赏胚,決...
    沈念sama閱讀 38,882評(píng)論 3 404
  • 文/蒼蘭香墨 我猛地睜開眼,長吁一口氣:“原來是場噩夢啊……” “哼商虐!你這毒婦竟也來了觉阅?” 一聲冷哼從身側(cè)響起,我...
    開封第一講書人閱讀 37,643評(píng)論 0 266
  • 序言:老撾萬榮一對(duì)情侶失蹤秘车,失蹤者是張志新(化名)和其女友劉穎典勇,沒想到半個(gè)月后,有當(dāng)?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體叮趴,經(jīng)...
    沈念sama閱讀 44,095評(píng)論 1 303
  • 正文 獨(dú)居荒郊野嶺守林人離奇死亡割笙,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點(diǎn)故事閱讀 36,448評(píng)論 2 325
  • 正文 我和宋清朗相戀三年,在試婚紗的時(shí)候發(fā)現(xiàn)自己被綠了眯亦。 大學(xué)時(shí)的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片伤溉。...
    茶點(diǎn)故事閱讀 38,566評(píng)論 1 339
  • 序言:一個(gè)原本活蹦亂跳的男人離奇死亡般码,死狀恐怖,靈堂內(nèi)的尸體忽然破棺而出谈火,到底是詐尸還是另有隱情侈询,我是刑警寧澤,帶...
    沈念sama閱讀 34,253評(píng)論 4 328
  • 正文 年R本政府宣布糯耍,位于F島的核電站扔字,受9級(jí)特大地震影響,放射性物質(zhì)發(fā)生泄漏温技。R本人自食惡果不足惜革为,卻給世界環(huán)境...
    茶點(diǎn)故事閱讀 39,829評(píng)論 3 312
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望舵鳞。 院中可真熱鬧震檩,春花似錦、人聲如沸蜓堕。這莊子的主人今日做“春日...
    開封第一講書人閱讀 30,715評(píng)論 0 21
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽套才。三九已至迂猴,卻和暖如春,著一層夾襖步出監(jiān)牢的瞬間背伴,已是汗流浹背沸毁。 一陣腳步聲響...
    開封第一講書人閱讀 31,945評(píng)論 1 264
  • 我被黑心中介騙來泰國打工, 沒想到剛下飛機(jī)就差點(diǎn)兒被人妖公主榨干…… 1. 我叫王不留傻寂,地道東北人息尺。 一個(gè)月前我還...
    沈念sama閱讀 46,248評(píng)論 2 360
  • 正文 我出身青樓,卻偏偏與公主長得像疾掰,于是被迫代替她去往敵國和親搂誉。 傳聞我的和親對(duì)象是個(gè)殘疾皇子,可洞房花燭夜當(dāng)晚...
    茶點(diǎn)故事閱讀 43,440評(píng)論 2 348

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