圖片
![Foo](https://zh.wikipedia.org/static/images/project-logos/zhwiki.png)
標(biāo)題
井號加空格加內(nèi)容
強(qiáng)調(diào)
*強(qiáng)調(diào)*
或者_強(qiáng)調(diào)_
(示例:斜體)
又或者以制表符或至少四個(gè)空格縮進(jìn)的行,后面一種用法會(huì)讓Markdown保留所有的空白字符——而與之相反负乡,一般情況下牍白,Markdown會(huì)刪除所有換行和空格,打亂原有的縮進(jìn)和排版
一個(gè)強(qiáng)調(diào)字符, 即斜體, 可用
*asterisks*
或_underscores_
.
兩個(gè)強(qiáng)調(diào)字符, 即粗體, 可用**asterisks**
或__underscores__
.
也可以組合使用, 可用**asterisks and _underscores_**
.
而想展現(xiàn)刪除線, 可用兩條波浪線.~~Scratch this.~~
效果如下:
一個(gè)強(qiáng)調(diào)字符, 即斜體, 可用 asterisks 或 underscores.
兩個(gè)強(qiáng)調(diào)字符, 即粗體, 可用 asterisks 或 underscores.
也可以組合使用, 可用 asterisks and underscores.
而想展現(xiàn)刪除線, 可用兩條波浪線.Scratch this.
斷行
如果你真的想在Markdown中插入換行標(biāo)簽
<br>
抖棘,你可以在行尾輸入兩個(gè)或以上的空格茂腥,然后回車。 這樣插入換行十分麻煩切省,但是“每個(gè)換行都轉(zhuǎn)換為
”在 Markdown中并不合適最岗,所以只在你確定你需要時(shí)手動(dòng)添加。
引用
引用只需要在被引用的內(nèi)容段落開頭加上右尖括號
>
即可,多級引用>>
朝捆。你可以選擇只在開頭加一個(gè)般渡。也可以在每行前面都加一個(gè),效果是一樣的芙盘。
這一整段的內(nèi)容都會(huì)作為一個(gè)HTML的引用元素驯用。引用元素是會(huì)自動(dòng)優(yōu)化排版的(reflowable,可回流)儒老。
你可以任意地將引用的內(nèi)容包含進(jìn)來蝴乔,然后所有這些都會(huì)
被解析成為單獨(dú)一個(gè)引用元素。
鏈接
-
[鏈接文字](鏈接地址) 例子: [Markdown](http://zh.wikipedia.com/wiki/Markdown)
使用后:Markdown - 另一種選擇是驮樊,鏈接地址可以放在段落后面的腳注淘这,前面放上鏈接引用標(biāo)簽區(qū)分剥扣。舉例說,先在內(nèi)容行內(nèi)插入以下內(nèi)容:
[鏈接文字][鏈接引用標(biāo)簽]
然后在段落的后面(或者文檔的結(jié)尾)放上以下內(nèi)容铝穷,就可以生成一個(gè)鏈接:
[鏈接引用標(biāo)簽]: 鏈接地址 "鏈接標(biāo)題"
使用后:[鏈接文字][鏈接引用標(biāo)簽]
[鏈接引用標(biāo)簽]: 鏈接地址 "鏈接標(biāo)題"
水平分區(qū)線[編輯]
要生成水平分區(qū)線钠怯,可以在單獨(dú)一行里輸入3個(gè)或以上的短橫線、星號或者下劃線實(shí)現(xiàn)曙聂。短橫線和星號之間可以輸入任意空格晦炊。以下每一行都產(chǎn)生一條水平分區(qū)線。
* * *
***
*****
- - -
---------------------------------------
使用后:
列表
Markdown 支持有序列表和無序列表
- 無序列表使用星號宁脊、加號或是減號作為列表標(biāo)記:
* Red
* Green
* Blue
等同于
+ Red
+ Green
+ Blue
也等同于
- Red
- Green
- Blue
- 有序列表則使用數(shù)字接著一個(gè)英文句點(diǎn):
1.0 Bird
2. McHale
3. Parish
- 同時(shí)断国,你在列表標(biāo)記上使用的數(shù)字并不會(huì)影響輸出的 HTML 結(jié)果,上面的列表所產(chǎn)生的 HTML 標(biāo)記為:
<ol>
<li>Bird</li>
<li>McHale</li>
<li>Parish</li>
</ol>
實(shí)例化后為:
<ol>
<li>Bird</li>
<li>McHale</li>
<li>Parish</li>
</ol>
你都會(huì)得到完全相同的 HTML 輸出榆苞。重點(diǎn)在于稳衬,你可以讓 Markdown 文件的列表數(shù)字和輸出的結(jié)果相同,或是你懶一點(diǎn)坐漏,你可以完全不用在意數(shù)字的正確性薄疚。
如果你使用懶惰的寫法,建議第一個(gè)項(xiàng)目最好還是從 1. 開始赊琳,因?yàn)?Markdown 未來可能會(huì)支持有序列表的 start 屬性街夭。
列表項(xiàng)目標(biāo)記通常是放在最左邊,但是其實(shí)也可以縮進(jìn)躏筏,最多 3 個(gè)空格板丽,項(xiàng)目標(biāo)記后面則一定要接著至少一個(gè)空格或制表符。
要讓列表看起來更漂亮趁尼,你可以把內(nèi)容用固定的縮進(jìn)整理好:
- 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.
但是如果你懶埃碱,那也行:
* 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.
如果列表項(xiàng)目間用空行分開,在輸出 HTML 時(shí) Markdown 就會(huì)將項(xiàng)目內(nèi)容用 <p> 標(biāo)簽包起來酥泞,舉例來說:
* Bird
* Magic
會(huì)被轉(zhuǎn)換為:
<ul>
<li>Bird</li>
<li>Magic</li>
</ul>
但是這個(gè):
* Bird
* Magic
會(huì)被轉(zhuǎn)換為:
<ul>
<li><p>Bird</p></li>
<li><p>Magic</p></li>
</ul>
列表項(xiàng)目可以包含多個(gè)段落砚殿,每個(gè)項(xiàng)目下的段落都必須縮進(jìn) 4 個(gè)空格或是 1 個(gè)制表符:
1. This is a list item 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.
如果你每行都有縮進(jìn),看起來會(huì)看好很多婶博,當(dāng)然瓮具,再次地,如果你很懶惰凡人,Markdown 也允許:
* This is a list item with two paragraphs.
`This is the second paragraph in the list item. You're
only required to indent the first line. Lorem ipsum dolor
sit amet, consectetuer adipiscing elit.`
* Another item in the same list.
如果要在列表項(xiàng)目內(nèi)放進(jìn)引用名党,那 > 就需要縮進(jìn):
- A list item with a blockquote:
> This is a blockquote
> inside a list item.
如果要放代碼區(qū)塊的話,該區(qū)塊就需要縮進(jìn)兩次挠轴,也就是 8 個(gè)空格或是 2 個(gè)制表符:
* 一列表項(xiàng)包含一個(gè)列表區(qū)塊:
<代碼寫在這>
當(dāng)然传睹,項(xiàng)目列表很可能會(huì)不小心產(chǎn)生,像是下面這樣的寫法:
1986. What a great season.
換句話說岸晦,也就是在行首出現(xiàn)數(shù)字-句點(diǎn)-空白欧啤,要避免這樣的狀況睛藻,你可以在句點(diǎn)前面加上反斜杠。
1986\. What a great season.