概述
Markdown 是一種輕量級(jí)標(biāo)記語(yǔ)言氛改,它允許人們使用易讀易寫的純文本格式編寫文檔帐萎,然后轉(zhuǎn)換成格式豐富的HTML頁(yè)面。 —— 來(lái)自[維基百科]
簡(jiǎn)單的來(lái)說(shuō)胜卤,Markdown就是用“標(biāo)記符號(hào)”表示“格式”疆导。Markdown語(yǔ)法標(biāo)簽與HTML語(yǔ)法標(biāo)簽是一一對(duì)應(yīng)的,比如Markdown的二級(jí)標(biāo)題標(biāo)簽##就對(duì)應(yīng)著HTML中的<h2>...</h2>
標(biāo)記葛躏,而且Markdown是兼容HTML語(yǔ)法的澈段,如果你比較喜歡 HTML 的<a>
或 <img>
標(biāo)簽,可以直接在Markdown文檔中使用這些標(biāo)記紫新,而不用 Markdown 提供的鏈接或是圖像標(biāo)簽語(yǔ)法均蜜。
段落與換行
一個(gè) Markdown 段落是由一個(gè)或多個(gè)連續(xù)的文本行組成,它的前后要有一個(gè)以上的空行(空行的定義是顯示上看起來(lái)像是空的芒率,便會(huì)被視為空行囤耳。若某一行只包含空格和制表符,也會(huì)被視為空行)偶芍。Markdown 允許段落內(nèi)的強(qiáng)迫換行(插入換行符)充择,普通段落不該用空格或制表符來(lái)縮進(jìn)。
標(biāo)題
Markdown 支持兩種標(biāo)題的語(yǔ)法匪蟀,類 Setext 和類 atx 形式椎麦。
類 Setext 形式是用底線的形式,利用 =(最高階標(biāo)題)和 -(第二階標(biāo)題)材彪。
This is an H1
=========
This is an H2
----------------
顯示效果:
This is an H1
=========
This is an H2
類 Atx 形式則是在行首插入 1 到 6 個(gè) # 观挎,對(duì)應(yīng)到標(biāo)題 1 到 6 階,例如:
# 這是 H1
## 這是 H2
#### 這是 H4
顯示效果:
這是 H1
這是 H2
這是 H4
區(qū)塊引用 Blockquotes
Markdown 文件中建立一個(gè)區(qū)塊引用段化,那會(huì)看起來(lái)像是你自己先斷好行嘁捷,然后在每行的最前面加上>
,最好和文字之間保留一個(gè)空格显熏。
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. Suspendisse
> id sem consectetuer libero luctus adipiscing.
顯示出來(lái)會(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.
區(qū)塊引用可以嵌套(例如:引用內(nèi)的引用)雄嚣,只要根據(jù)層次加上不同數(shù)量的>
,而且引用的區(qū)塊內(nèi)也可以使用其他的 Markdown 語(yǔ)法喲,標(biāo)題缓升,列表鼓鲁,代碼區(qū)快都可以用,還是很方便很優(yōu)雅的~
舉例:
> ## she
> 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.
真實(shí)顯示是這樣的
she
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 中骇吭,你只需要在文字前面加上 - 就可以了。當(dāng)然啦封锉,在-
绵跷、1.
和文本之間也要保留一個(gè)字符的空格才是標(biāo)準(zhǔn)語(yǔ)法膘螟。
例如:
- 這是第一行
- 這是第二行
- 這是第三行
實(shí)際顯示:
- 這是第一行
- 這是第二行
- 這是第三行
如果想要展示一個(gè)有序列表成福,也可以在文字前面加上 1. 2. 3.,例如:
1.文本1
2.文本2
3.文本3
實(shí)際顯示:
1.文本1
2.文本2
3.文本3