markdown 易學(xué)易用(So easy!)

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

1 標(biāo)題

標(biāo)題共六級谢揪,一級標(biāo)題字號最大,字號隨著級別的增加遞減捐凭。leanote 最多支持五級標(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)題

2 列表

2.1 無序列表

無序列表項前的標(biāo)記符號可以使用*茁肠、+-患民,標(biāo)記符號后須加至少一個空格

+ 無序列表項1
- 無序列表項2
* 無序列表項3

顯示效果如下:

  • 無序列表項1
  • 無序列表項2
  • 無序列表項3

2.2 有序列表

有序列表項前加上數(shù)字和一個英文句號垦梆,英文句號后須加至少一個空格匹颤。數(shù)字的大小排序不影響最終顯示的效果。

1. 有序列表項 1
3. 有序列表項 2
8. 有序列表項 3

顯示效果如下:

  1. 有序列表項1
  2. 有序列表項2
  3. 有序列表項3

注:leanote 的 markdown 編輯器托猩,無序和有序列表前還需要添加一個空行印蓖,簡書不需要。

3 注腳

在需要加注的文字后加上[^note]京腥,即可加上注腳赦肃,具體語法如下所示。注意公浪,這里的腳注1, note2 和 footnote3 可以換成其他文字他宛,只要前后保持一致即可。

使用 Markdown[^腳注1]可以效率地書寫文檔欠气,直接轉(zhuǎn)換成 HTML[^note2]厅各,你可以使用 Leanote[^footnote3] 編輯器進(jìn)行書寫。

(注:leanote 的 markdown 編輯器预柒,以下各個注腳解釋之間還需要用一個空行分隔队塘,簡書不需要)

[^腳注1]:Markdown 是一種純文本標(biāo)記語言

[^note2]:HyperText Markup Language 超文本標(biāo)記語言

[^footnote3]:開源筆記平臺袁梗,支持 Markdown 和筆記直接發(fā)為博文

顯示效果如下:

使用 Markdown[1]可以效率地書寫文檔,直接轉(zhuǎn)換成 HTML[2]憔古,你可以使用 Leanote[3] 編輯器進(jìn)行書寫遮怜。

4 插入鏈接

鏈接可指定 title 屬性,也可省略投放。如定義了 title 屬性,當(dāng)鼠標(biāo)懸停在鏈接文字上時會顯示 title 屬性的值适贸。

[鏈接文字](鏈接地址 "title")

例如:[簡書](http://www.reibang.com/  "簡書官網(wǎng)")

顯示效果如下:

簡書

<>將鏈接包圍起來灸芳,即自動轉(zhuǎn)換成鏈接。

<http://example.com/>
<address@example.com>

顯示效果如下:

http://example.com/
address@example.com

5 插入圖片

插入圖片的語法為:![](圖片鏈接 圖片title)拜姿。

  • 圖片 alt 是當(dāng)圖片無法顯示時烙样,替代圖片的文字信息,可省略蕊肥。
  • 圖片 title 是當(dāng)鼠標(biāo)懸停在圖片上時顯示的文字谒获,可省略。
![宋民咕 魚香肉絲里面沒有肉](http://upload-images.jianshu.io/upload_images/4558002-00c60a9b78e694da.jpg?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240 "宋民咕")

顯示效果如下:

宋民咕 魚香肉絲里面沒有肉

6 區(qū)塊引用

引用文本時壁却,在文本前加>即可批狱,> 與引用文本之間需保留一個空格。

> 假如生活欺騙了你
> 不要悲傷展东,不要心急
> 憂郁的日子里需要鎮(zhèn)靜
> 相信吧赔硫,快樂的日子將會來臨
> 心兒永遠(yuǎn)向往著未來
> 現(xiàn)在卻常是憂郁
> 一切都是瞬息,一切都將會過去
> 而那過去了的盐肃,就會成為親切的懷戀

顯示效果如下:

假如生活欺騙了你
不要悲傷爪膊,不要心急
憂郁的日子里需要鎮(zhèn)靜
相信吧,快樂的日子將會來臨
心兒永遠(yuǎn)向往著未來
現(xiàn)在卻常是憂郁
一切都是瞬息砸王,一切都將會過去
而那過去了的推盛,就會成為親切的懷戀

區(qū)塊引用可以嵌套(引用內(nèi)的引用),還可以在引用內(nèi)使用其他的 markdown 語法谦铃,例如:

> 宋代歐陽修則云:
> 最佳讀書時間耘成,乃為三上:即**枕上**、**馬上**驹闰、**廁上**凿跳。
> —— *劉真《論讀書》*

顯示效果如下:

宋代歐陽修則云:
最佳讀書時間,乃為三上:即枕上疮方、馬上控嗜、廁上
—— 劉真《論讀書》

7 粗體骡显、斜體疆栏、加粗斜體和刪除線

具體語法如下:

1. **粗體**
2. *斜體*
3. ***加粗斜體***
4. ~~刪除線~~

顯示效果如下:

  1. 粗體
  2. 斜體
  3. 加粗斜體
  4. 刪除線

8 輸入代碼

8.1 輸入單行代碼

輸入單行代碼的語法:`單行代碼`曾掂。顯示效果如下:

var a = 1

8.2 輸入多行代碼

輸入多行代碼的語法如下,在第一行的 ``` 后面加上代碼語言壁顶,leanote 和簡書都能實現(xiàn)語法高亮珠洗。
在每行代碼前輸入四個或四個以上的空格也能實現(xiàn)代碼塊的效果。

```python
class Employee:
empCount = 0

def init(self, name, salary):
self.name = name
self.salary = salary
Employee.empCount += 1
```

顯示效果如下:

class Employee:
   empCount = 0
   def __init__(self, name, salary):
        self.name = name
        self.salary = salary
        Employee.empCount += 1

9 表格

表格第一行為表頭若专,第二行分隔表頭與表格主體部分许蓖,第三行開始為表格主體部分。
列與列之間以|分隔调衰。
第二行還可為不同列指定對齊方式膊爪,|:------:|為居中對齊,|------:|為右對齊嚎莉,|:------|為左對齊米酬。

|table |table   |table  |
|:-----|:------:|------:|
|1     |2       |3      |
|4     |5       |6      |

顯示效果如下:

table table table
1 2 3
4 5 6

10 分隔線

輸入三個以上的*-_即可生成分隔線趋箩,*赃额、-_之間可插入空格。

***

---

___

顯示效果如下:




11 定義

如果需要對某個名詞的定義作出解釋叫确,可以選用以下語法格式跳芳,目前簡書不支持這個功能,leanote 支持竹勉。

名詞 1
:    定義 1(左側(cè)有一個冒號和四個空格)

leanote 上的顯示效果如下:

12 Html 標(biāo)簽

leanote 支持在 Markdown 語法中嵌套 Html 標(biāo)簽筛严,簡書不支持。譬如饶米,你可以用 Html 寫一個縱跨兩行的表格:

<table>
    <tr>
        <th rowspan="2">值班人員</th>
        <th>星期一</th>
        <th>星期二</th>
        <th>星期三</th>
    </tr>
    <tr>
        <td>李強(qiáng)</td>
        <td>張明</td>
        <td>王平</td>
    </tr>
</table>

leanote 上的顯示效果如下:

也可以通過 img 標(biāo)簽插入圖片桨啃,利用 img 標(biāo)簽的 height 和 width 屬性來設(shè)置圖片的高度和寬度。

![](http://upload-images.jianshu.io/upload_images/4558002-73942e9b78c2b21e.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)

leanote 上的顯示效果如下:

13 目錄

通過 [TOC] 在文檔中插入目錄檬输,簡書暫不支持照瘾。leanote 上的顯示效果如下:

14 其他

想更多地了解和學(xué)習(xí) markdown,可參閱以下資料:


  1. Markdown 是一種純文本標(biāo)記語言 ?

  2. HyperText Markup Language 超文本標(biāo)記語言 ?

  3. 開源筆記平臺丧慈,支持 Markdown 和筆記直接發(fā)為博文 ?

最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
  • 序言:七十年代末析命,一起剝皮案震驚了整個濱河市,隨后出現(xiàn)的幾起案子逃默,更是在濱河造成了極大的恐慌鹃愤,老刑警劉巖,帶你破解...
    沈念sama閱讀 212,718評論 6 492
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件完域,死亡現(xiàn)場離奇詭異软吐,居然都是意外死亡,警方通過查閱死者的電腦和手機(jī)吟税,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 90,683評論 3 385
  • 文/潘曉璐 我一進(jìn)店門凹耙,熙熙樓的掌柜王于貴愁眉苦臉地迎上來姿现,“玉大人,你說我怎么就攤上這事肖抱”傅洌” “怎么了?”我有些...
    開封第一講書人閱讀 158,207評論 0 348
  • 文/不壞的土叔 我叫張陵意述,是天一觀的道長提佣。 經(jīng)常有香客問我,道長荤崇,這世上最難降的妖魔是什么拌屏? 我笑而不...
    開封第一講書人閱讀 56,755評論 1 284
  • 正文 為了忘掉前任,我火速辦了婚禮天试,結(jié)果婚禮上槐壳,老公的妹妹穿的比我還像新娘然低。我一直安慰自己喜每,他們只是感情好,可當(dāng)我...
    茶點故事閱讀 65,862評論 6 386
  • 文/花漫 我一把揭開白布雳攘。 她就那樣靜靜地躺著带兜,像睡著了一般。 火紅的嫁衣襯著肌膚如雪吨灭。 梳的紋絲不亂的頭發(fā)上刚照,一...
    開封第一講書人閱讀 50,050評論 1 291
  • 那天,我揣著相機(jī)與錄音喧兄,去河邊找鬼无畔。 笑死,一個胖子當(dāng)著我的面吹牛吠冤,可吹牛的內(nèi)容都是我干的浑彰。 我是一名探鬼主播,決...
    沈念sama閱讀 39,136評論 3 410
  • 文/蒼蘭香墨 我猛地睜開眼拯辙,長吁一口氣:“原來是場噩夢啊……” “哼郭变!你這毒婦竟也來了?” 一聲冷哼從身側(cè)響起涯保,我...
    開封第一講書人閱讀 37,882評論 0 268
  • 序言:老撾萬榮一對情侶失蹤诉濒,失蹤者是張志新(化名)和其女友劉穎,沒想到半個月后夕春,有當(dāng)?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體未荒,經(jīng)...
    沈念sama閱讀 44,330評論 1 303
  • 正文 獨居荒郊野嶺守林人離奇死亡,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點故事閱讀 36,651評論 2 327
  • 正文 我和宋清朗相戀三年及志,在試婚紗的時候發(fā)現(xiàn)自己被綠了茄猫。 大學(xué)時的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片狈蚤。...
    茶點故事閱讀 38,789評論 1 341
  • 序言:一個原本活蹦亂跳的男人離奇死亡,死狀恐怖划纽,靈堂內(nèi)的尸體忽然破棺而出脆侮,到底是詐尸還是另有隱情,我是刑警寧澤勇劣,帶...
    沈念sama閱讀 34,477評論 4 333
  • 正文 年R本政府宣布靖避,位于F島的核電站,受9級特大地震影響比默,放射性物質(zhì)發(fā)生泄漏幻捏。R本人自食惡果不足惜,卻給世界環(huán)境...
    茶點故事閱讀 40,135評論 3 317
  • 文/蒙蒙 一命咐、第九天 我趴在偏房一處隱蔽的房頂上張望篡九。 院中可真熱鬧,春花似錦醋奠、人聲如沸榛臼。這莊子的主人今日做“春日...
    開封第一講書人閱讀 30,864評論 0 21
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽沛善。三九已至,卻和暖如春塞祈,著一層夾襖步出監(jiān)牢的瞬間金刁,已是汗流浹背。 一陣腳步聲響...
    開封第一講書人閱讀 32,099評論 1 267
  • 我被黑心中介騙來泰國打工议薪, 沒想到剛下飛機(jī)就差點兒被人妖公主榨干…… 1. 我叫王不留尤蛮,地道東北人。 一個月前我還...
    沈念sama閱讀 46,598評論 2 362
  • 正文 我出身青樓斯议,卻偏偏與公主長得像产捞,于是被迫代替她去往敵國和親。 傳聞我的和親對象是個殘疾皇子捅位,可洞房花燭夜當(dāng)晚...
    茶點故事閱讀 43,697評論 2 351

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

  • 1. 斜體和粗體 代碼: 顯示效果: 這是一段斜體 這是一段粗體 這是一段加粗斜體 這是一段刪除線 2. 分級標(biāo)題...
    泊牧閱讀 2,332評論 0 2
  • 為什么學(xué)習(xí)Markdown 自從搭建了 Hexo 博客之后轧葛,發(fā)現(xiàn)還有 Markdown 這種寫文章的方法,想到以后...
    lifeColder閱讀 20,144評論 10 217
  • 上課總結(jié):從機(jī)器語言(010101010)->匯編語言(add 1,2)有意義的英文單詞--->結(jié)構(gòu)化->面向?qū)ο?..
    程序員有話說閱讀 982評論 1 1
  • 蕙質(zhì)蘭心艇搀,曉情達(dá)理尿扯。 孝負(fù)終身,良人未及焰雕。 恬退隱忍衷笋,抑郁成疾。 韶華已去矩屁,空留...
    蘭雪清風(fēng)閱讀 287評論 0 1
  • 老爸的病現(xiàn)在是我一心頭病辟宗,雖跟其他親人常一同討論爵赵,但其實內(nèi)心的想法又是無處訴說,不得不寫下來以解心憂泊脐,也讓心理方面...
    梵芃閱讀 146評論 0 0