markdown 易學易用(So easy!)

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

1 標題

標題共六級,一級標題字號最大,字號隨著級別的增加遞減。leanote 最多支持五級標題,簡書可支持六級。

# 一級標題
## 二級標題
### 三級標題
#### 四級標題
##### 五級標題
###### 六級標題

顯示效果如下:

一級標題

二級標題

三級標題

四級標題

五級標題
六級標題

2 列表

2.1 無序列表

無序列表項前的標記符號可以使用*+-,標記符號后須加至少一個空格。

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

顯示效果如下:

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

2.2 有序列表

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

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

顯示效果如下:

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

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

3 注腳

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

使用 Markdown[^腳注1]可以效率地書寫文檔,直接轉換成 HTML[^note2],你可以使用 Leanote[^footnote3] 編輯器進行書寫。

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

[^腳注1]:Markdown 是一種純文本標記語言

[^note2]:HyperText Markup Language 超文本標記語言

[^footnote3]:開源筆記平臺,支持 Markdown 和筆記直接發為博文

顯示效果如下:

使用 Markdown[1]可以效率地書寫文檔,直接轉換成 HTML[2],你可以使用 Leanote[3] 編輯器進行書寫。

4 插入鏈接

鏈接可指定 title 屬性,也可省略。如定義了 title 屬性,當鼠標懸停在鏈接文字上時會顯示 title 屬性的值。

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

例如:[簡書](http://www.lxweimin.com/  "簡書官網")

顯示效果如下:

簡書

<>將鏈接包圍起來,即自動轉換成鏈接。

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

顯示效果如下:

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

5 插入圖片

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

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

顯示效果如下:

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

6 區塊引用

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

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

顯示效果如下:

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

區塊引用可以嵌套(引用內的引用),還可以在引用內使用其他的 markdown 語法,例如:

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

顯示效果如下:

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

7 粗體、斜體、加粗斜體和刪除線

具體語法如下:

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

顯示效果如下:

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

8 輸入代碼

8.1 輸入單行代碼

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

var a = 1

8.2 輸入多行代碼

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

```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(左側有一個冒號和四個空格)

leanote 上的顯示效果如下:

12 Html 標簽

leanote 支持在 Markdown 語法中嵌套 Html 標簽,簡書不支持。譬如,你可以用 Html 寫一個縱跨兩行的表格:

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

leanote 上的顯示效果如下:

也可以通過 img 標簽插入圖片,利用 img 標簽的 height 和 width 屬性來設置圖片的高度和寬度。

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

leanote 上的顯示效果如下:

13 目錄

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

14 其他

想更多地了解和學習 markdown,可參閱以下資料:


  1. Markdown 是一種純文本標記語言 ?

  2. HyperText Markup Language 超文本標記語言 ?

  3. 開源筆記平臺,支持 Markdown 和筆記直接發為博文 ?

最后編輯于
?著作權歸作者所有,轉載或內容合作請聯系作者
平臺聲明:文章內容(如有圖片或視頻亦包括在內)由作者上傳并發布,文章內容僅代表作者本人觀點,簡書系信息發布平臺,僅提供信息存儲服務。
  • 序言:七十年代末,一起剝皮案震驚了整個濱河市,隨后出現的幾起案子,更是在濱河造成了極大的恐慌,老刑警劉巖,帶你破解...
    沈念sama閱讀 230,501評論 6 544
  • 序言:濱河連續發生了三起死亡事件,死亡現場離奇詭異,居然都是意外死亡,警方通過查閱死者的電腦和手機,發現死者居然都...
    沈念sama閱讀 99,673評論 3 429
  • 文/潘曉璐 我一進店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來,“玉大人,你說我怎么就攤上這事。” “怎么了?”我有些...
    開封第一講書人閱讀 178,610評論 0 383
  • 文/不壞的土叔 我叫張陵,是天一觀的道長。 經常有香客問我,道長,這世上最難降的妖魔是什么? 我笑而不...
    開封第一講書人閱讀 63,939評論 1 318
  • 正文 為了忘掉前任,我火速辦了婚禮,結果婚禮上,老公的妹妹穿的比我還像新娘。我一直安慰自己,他們只是感情好,可當我...
    茶點故事閱讀 72,668評論 6 412
  • 文/花漫 我一把揭開白布。 她就那樣靜靜地躺著,像睡著了一般。 火紅的嫁衣襯著肌膚如雪。 梳的紋絲不亂的頭發上,一...
    開封第一講書人閱讀 56,004評論 1 329
  • 那天,我揣著相機與錄音,去河邊找鬼。 笑死,一個胖子當著我的面吹牛,可吹牛的內容都是我干的。 我是一名探鬼主播,決...
    沈念sama閱讀 44,001評論 3 449
  • 文/蒼蘭香墨 我猛地睜開眼,長吁一口氣:“原來是場噩夢啊……” “哼!你這毒婦竟也來了?” 一聲冷哼從身側響起,我...
    開封第一講書人閱讀 43,173評論 0 290
  • 序言:老撾萬榮一對情侶失蹤,失蹤者是張志新(化名)和其女友劉穎,沒想到半個月后,有當地人在樹林里發現了一具尸體,經...
    沈念sama閱讀 49,705評論 1 336
  • 正文 獨居荒郊野嶺守林人離奇死亡,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內容為張勛視角 年9月15日...
    茶點故事閱讀 41,426評論 3 359
  • 正文 我和宋清朗相戀三年,在試婚紗的時候發現自己被綠了。 大學時的朋友給我發了我未婚夫和他白月光在一起吃飯的照片。...
    茶點故事閱讀 43,656評論 1 374
  • 序言:一個原本活蹦亂跳的男人離奇死亡,死狀恐怖,靈堂內的尸體忽然破棺而出,到底是詐尸還是另有隱情,我是刑警寧澤,帶...
    沈念sama閱讀 39,139評論 5 364
  • 正文 年R本政府宣布,位于F島的核電站,受9級特大地震影響,放射性物質發生泄漏。R本人自食惡果不足惜,卻給世界環境...
    茶點故事閱讀 44,833評論 3 350
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧,春花似錦、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 35,247評論 0 28
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至,卻和暖如春,著一層夾襖步出監牢的瞬間,已是汗流浹背。 一陣腳步聲響...
    開封第一講書人閱讀 36,580評論 1 295
  • 我被黑心中介騙來泰國打工, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留,地道東北人。 一個月前我還...
    沈念sama閱讀 52,371評論 3 400
  • 正文 我出身青樓,卻偏偏與公主長得像,于是被迫代替她去往敵國和親。 傳聞我的和親對象是個殘疾皇子,可洞房花燭夜當晚...
    茶點故事閱讀 48,621評論 2 380

推薦閱讀更多精彩內容

  • 1. 斜體和粗體 代碼: 顯示效果: 這是一段斜體 這是一段粗體 這是一段加粗斜體 這是一段刪除線 2. 分級標題...
    泊牧閱讀 2,366評論 0 2
  • 為什么學習Markdown 自從搭建了 Hexo 博客之后,發現還有 Markdown 這種寫文章的方法,想到以后...
    lifeColder閱讀 20,178評論 10 216
  • 上課總結:從機器語言(010101010)->匯編語言(add 1,2)有意義的英文單詞--->結構化->面向對象...
    程序員有話說閱讀 999評論 1 1
  • 蕙質蘭心,曉情達理。 孝負終身,良人未及。 恬退隱忍,抑郁成疾。 韶華已去,空留...
    蘭雪清風閱讀 304評論 0 1
  • 老爸的病現在是我一心頭病,雖跟其他親人常一同討論,但其實內心的想法又是無處訴說,不得不寫下來以解心憂,也讓心理方面...
    梵芃閱讀 148評論 0 0