Markdown語法學習筆記

[TOC]

Markdown
: 是一種電子郵件風格的標記語言茅主,通常為程序員群體所使用纵刘。同時,Markdown支持嵌入html標簽犬第。

使用Markdown的好處

  1. 兼顧了[什么人都能打開]和[樣式]锦积,由于是純文本,Markdown文稿也不會因為未來的軟件升級而產(chǎn)生不同版本之間的兼容問題和樣式預覽不一致的問題歉嗓。
  2. 讓你專注于寫作的文字而不是排版丰介。
  3. Markdown轉(zhuǎn)HTML非常方便,HTML是整個萬維網(wǎng)(WEB)的標記語言鉴分,更重要的是哮幢,它也是目前主流電子書格式所用的標記語言,采用Markdown進行文章的編輯志珍,對于日后的文件轉(zhuǎn)換工作也大有裨益橙垢。
  4. Markdown的標記語法有極好的可讀性。

兼容HTML

  1. Markdown語法的目標是成為一種適用于網(wǎng)絡的書寫語言伦糯,Markdown不是想要取代HTML柜某。
  2. Markdown的理念是嗽元,能讓文檔更容易讀、寫喂击、改剂癌。HTML是一種發(fā)布的格式,Markdown是一種書寫的格式翰绊,Markdown的格式語法只涵蓋純文本可以涵蓋的范圍佩谷。
  3. 不在Markdown涵蓋范圍之內(nèi)的標簽,都可以直接在文檔里面用HTML撰寫监嗜。不需要額外標注這是HTML或是Markdown谐檀,只要直接加標簽即可。
  4. 在HTML區(qū)塊標簽間的Markdown格式語法將不會被處理秤茅。
  5. HTML的行內(nèi)標簽如<span>稚补、<cite>童叠、<del>可以在Markdown的段落框喳、列表或是標題里隨意使用。如果比較喜歡HTML的<a><img> 標簽厦坛,可以直接使用這些標簽五垮,而不用Markdown提供的鏈接或是圖像標簽語法。

Markdown的常用語法介紹:

標題

Markdown標題標記支持兩種形式杜秸,常用的#標記形式和=-標記形式(注意:=-標記形式放仗,只支持第一級和第二級標題,后續(xù)標題不再支持)撬碟。

標題形式一

在需要設置為標題的文字前面加上#號并空格诞挨,Markdown的#標記形式支持一級標題、二級標題呢蛤、三級標題惶傻、四級標題、五級標題其障、六級標題银室,總共六級,標題字號相應降低励翼。

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

顯示效果:<br />
# 一級標題<br />
## 二級標題<br />
### 三級標題<br />
#### 四級標題<br />
##### 五級標題<br />
###### 六級標題<br />

標記形式二(只支持第一級和第二級標題)

標題文字下一行加上任意個=表示第一級標題蜈敢,加上任意個-表示第二級標題。

# 一級標題
一級標題
=

## 二級標題
二級標題
-

顯示效果:

# 一級標題
一級標題
=

## 二級標題
二級標題
-

由于用了[TOC]標記編輯器會把所有標題寫到目錄大綱中汽抚,在這里寫的演示標題也會列進去抓狭,所以就不演示了。

注:# 和「一級標題」之間建議保留一個字符的空格造烁,這是最標準的Markdown寫法否过。

列表

無序列表

列表格式也很常用狱从,在Markdown中,你只需要在列表文字前面加上+叠纹、-季研、*并空格即可。

+ 文本1
+ 文本2
+ 文本3

顯示效果:

  • 文本1
  • 文本2
  • 文本3
- 文本1
- 文本2
- 文本2

顯示效果:

  • 文本1
  • 文本2
  • 文本2
* 文本1
* 文本2
* 文本3

顯示效果:

  • 文本1
  • 文本2
  • 文本3
有序列表

如果你希望是有序列表,可以在列表文字前面加上1. 2. 3. 或者 1. 1. 1. 甚至 1. 7. 5.并與文字之間有一個空格即可誉察。

1. 文本1
2. 文本1
3. 文本1

顯示效果:

  1. 文本1
  2. 文本1
  3. 文本1
1. 文本1
1. 文本1
1. 文本1

顯示效果:

  1. 文本1
  2. 文本1
  3. 文本1
1. 文本1
7. 文本1
5. 文本1

顯示效果:

  1. 文本1
  2. 文本1
  3. 文本1

注:

  1. - 与涡、1.和文本之間要保留一個字符的空格,這是最標準的Markdown寫法持偏。
  2. 有序列表驼卖,會使用第一行的數(shù)字作為開始項,如:7.在第一行鸿秆,默認就以7作為序列的開始酌畜。
定義型列表

定義型列表
: 定義型列表由名詞和解釋組成,第一行寫上定義卿叽,緊跟一行寫上解釋桥胞。解釋的寫法:后面緊跟一個縮進[Tab]。

Markdown
:   Markdown是輕量級文本標記語言考婴,可以轉(zhuǎn)換成Html贩虾、Pdf等格式。   // 左側(cè)有一個可見的冒號和四個不可見的空格(`:` `Tab`)

文字代碼塊
:   如下方式是對代碼塊的定義      // 左側(cè)有一個可見的冒號和四個不可見的空格(`:` `Tab`)

        文字代碼塊      // 左側(cè)有八個不可見的空格沥阱,即兩個`Tab`鍵缎罢。
        public static void main(String[] args){
            System.out.println("Hello World!!!");
        }

顯示效果:

Markdown
: Markdown是輕量級文本標記語言,可以轉(zhuǎn)換成Html考杉、Pdf等格式策精。 // 左側(cè)有一個可見的冒號和四個不可見的空格(: Tab

文字代碼塊
: 如下方式是對代碼塊的定義 // 左側(cè)有一個可見的冒號和四個不可見的空格(: Tab

    文字代碼塊      // 左側(cè)有八個不可見的空格,即兩個`Tab`鍵崇棠。
    public static void main(String[] args){
        System.out.println("Hello World!!!");
    }

編碼代碼塊

public static void main(String[] args){
    System.out.println("Hello World!!!");
}
列表縮進

列表項目標記通常是放在最左邊咽袜,但是其實也可以縮進,最多 3 個空格易茬,項目標記后面則一定要接著至少一個空格或制表符(Tab)酬蹋。

包含段落的列表

列表項目可以包含多個段落,每個項目下的段落都必須縮進 4 個空格或是 1 個制表符抽莱。

超鏈接

普通超鏈接

在Markdown中范抓,插入鏈接不需要用其他按鈕,你只需要使用[顯示文本](鏈接地址)或者[顯示文本](鏈接地址 "鼠標懸浮文字")這樣的語法即可食铐。

Welcome to [Rambo科技無限空間](http://www.rambo123.com)
Welcome to [Rambo科技無限空間](http://www.rambo123.com "Rambo科技無限空間")

顯示效果:

Welcome to Rambo科技無限空間 <br />
Welcome to Rambo科技無限空間

自動超鏈接

Markdown支持以比較簡短的自動鏈接形式來處理網(wǎng)址和電子郵件信箱匕垫,只要是用<>包起來, Markdown就會自動把它轉(zhuǎn)成鏈接虐呻。一般網(wǎng)址的鏈接文字就和鏈接地址一樣象泵。

<http://www.rambo123.com>
<adress@rambo1203@sina.com>

顯示效果:

http://www.rambo123.com <br />
rambo1203@sina.com

參考式超鏈接

參考式超鏈接一般用在學術論文上面寞秃,或者另一種情況,如果某一個鏈接在文章中多處使用偶惠,那么使用引用 的方式創(chuàng)建鏈接將非常好春寿,它可以讓你對鏈接進行統(tǒng)一的管理。

語法說明:

  1. 參考式鏈接分為兩部分忽孽,文中的寫法 [鏈接文字][鏈接標記]绑改,在文本的任意位置添加[鏈接標記]:鏈接地址 “鏈接標題”,鏈接地址與鏈接標題中間有一個空格兄一。

  2. 如果鏈接文字本身可以做為鏈接標記厘线,你也可以寫成[鏈接文字][]
    [鏈接文字]:鏈接地址的形式,見示例的最后一行出革。

代碼片段:

我經(jīng)常去的幾個網(wǎng)站[Google][1]造壮、[Leanote][2]以及[自己的網(wǎng)站][3]
[Leanote 筆記][2]是一個不錯的[網(wǎng)站][]。

[1]:http://www.google.com "Google"
[2]:http://www.leanote.com "Leanote"
[3]:http:/www.rambo123.com "Rambo科技無限空間"
[網(wǎng)站]:http://blog.leanote.com/freewalk

顯示效果:

我經(jīng)常去的幾個網(wǎng)站Google骂束、Leanote以及自己的網(wǎng)站
Leanote 筆記是一個不錯的網(wǎng)站耳璧。

插入網(wǎng)絡圖片

在Markdown中,插入圖片不需要其他按鈕栖雾,你只需要使用[圖片上傳失敗...(image-6f083-1515913533862)]這樣的語法即可楞抡。

![](https://timgsa.baidu.com/timg?image&quality=80&size=b9999_10000&sec=1515838217861&di=247e346671a85c14290807e2ef2cc087&imgtype=0&src=http%3A%2F%2Fimg.9553.com%2Fuploadfile%2F2016%2F0111%2F20160111010743581.jpg)

顯示效果:

[圖片上傳失敗...(image-50947e-1515913533862)]

注:插入圖片的語法和鏈接的語法很像伟众,只是前面多了一個 !析藕。

文字引用

在我們寫作的時候經(jīng)常需要應用他人的文字,這個時候應用這個格式就很有必要了凳厢,在Markdown中账胧,你只需要在你希望引用的文字簽名加上>并和該文字有一個空格即可。

> 一盞燈先紫, 一片昏黃治泥; 一簡書, 一杯淡茶遮精。 守著那一份淡定居夹, 品讀屬于自己的寂寞。 保持淡定本冲, 才能欣賞到最美麗的風景准脂! 保持淡定, 人生從此不再寂寞檬洞。

顯示效果:

一盞燈狸膏, 一片昏黃; 一簡書添怔, 一杯淡茶湾戳。 守著那一份淡定贤旷, 品讀屬于自己的寂寞。 保持淡定砾脑, 才能欣賞到最美麗的風景幼驶! 保持淡定, 人生從此不再寂寞韧衣。

注:> 和文本之間要保留一個字符的空格县遣,這是最標準的Markdown寫法。

代碼引用

需要應用代碼時汹族,如果引用的語句只有一段萧求,不分行,可以用 ` 將語句包起來顶瞒。如果引用的語句為多行夸政,可以將 ``` 置于這段代碼的首行和末行,其中首行可以指定引用代碼的語言榴徐,Markdown支持該語法的高亮支持守问。

單行代碼引用

Hello World!

多行代碼引用
public static void main(String[] args){
    System.out.println("Hello World!!!");
}

綜合引用

引用用>表示,應用支持多級引用坑资、標題耗帕、列表、代碼塊袱贮、分割線等常規(guī)語法仿便。

常見的引用寫法

---
> 這是一段引用          // 在`>`后面有一個空格
>
>     這是引用的代碼塊形式          // 在`>`后面有五個空格
>
> 代碼例子
>
     public static void main(String[] args){
         System.out.println("Hello World!!!");
     }
---

---
> 一級引用
> > 二級引用            // 每個`>`后面都有一個空格
> > > 三級引用          // 每個`>`后面都有一個空格

> #### 這是一個四級標題
>
> 1. 這是引用中的有序列表項第一行
> 2. 這是引用中的有序列表項第二行
>
---

> 以下是分割線
***

顯示效果:


這是一段引用 // 在>后面有一個空格

這是引用的代碼塊形式          // 在`>`后面有五個空格

代碼例子

 public static void main(String[] args){
     System.out.println("Hello World!!!");
 }


一級引用

二級引用 // 每個>后面都有一個空格

三級引用 // 每個>后面都有一個空格

這是一個四級標題

  1. 這是引用中的有序列表項第一行
  2. 這是引用中的有序列表項第二行

以下是分割線


粗體、斜體刪除線

Markdown在粗體和斜體也非常簡單攒巍,用**或者__包含一段文本就是粗體的語法嗽仪,用*或者_包含一段文本就是斜體的語法,用***或者___包含一段文本就是加粗斜體柒莉。Markdown的刪除線則采用~~包含一段文本即可闻坚。

**我是粗體**
__我是粗體__

顯示效果:

我是粗體
我是粗體

*我是斜體*
_我是斜體_

顯示效果:

我是斜體
我是斜體

***我是加粗斜體***
___我是加粗斜體___

顯示效果:

我是加粗斜體
我是加粗斜體

~~刪除線~~

顯示效果:

刪除線

注:但是如果你的 * 和 _ 兩邊都有空白的話,它們就只會被當成普通的符號兢孝。

表格

表格對齊格式:

  • 居左(默認對齊方式): :----
  • 標題居中窿凤,內(nèi)容居中: :----:
  • 標題居中,內(nèi)容居左: ----
  • 居右: ----:

相關代碼1:

| 標題和內(nèi)容居左               | 標題和內(nèi)容居中               | 標題居中內(nèi)容居左                 | 標題和內(nèi)容居右               |
| :--------------------------- | :--------------------------: | -------------------------------- | ---------------------------: |
| 居左                         | 居中                         | 居中和居左                       | 居右                         |
| 標題和內(nèi)容居左               | 標題和內(nèi)容居中               | 標題居中內(nèi)容居左                 | 標題和內(nèi)容居右               |
| 標題和內(nèi)容居左標題和內(nèi)容居左 | 標題和內(nèi)容居中標題和內(nèi)容居中 | 標題居中內(nèi)容居左標題居中內(nèi)容居左 | 標題和內(nèi)容居右標題和內(nèi)容居右 |

顯示效果1:

標題和內(nèi)容居左 標題和內(nèi)容居中 標題居中內(nèi)容居左 標題和內(nèi)容居右
居左 居中 居中和居左 居右
標題和內(nèi)容居左 標題和內(nèi)容居中 標題居中內(nèi)容居左 標題和內(nèi)容居右
標題和內(nèi)容居左標題和內(nèi)容居左 標題和內(nèi)容居中標題和內(nèi)容居中 標題居中內(nèi)容居左標題居中內(nèi)容居左 標題和內(nèi)容居右標題和內(nèi)容居右

相關代碼2(無格式):

dog | bird | cat
----|------|----
foo | foo  | foo
bar | bar  | bar
baz | baz  | baz

顯示效果2:

dog bird cat
foo foo foo
bar bar bar
baz baz baz

分隔線

你可以在一行中連續(xù)不間斷(如有間斷跨蟹,中間必須是空格)使用三個或以上的*雳殊、-_來建立分隔線喷市。


***

---

___

* * * 

- - - 

_ _ _


顯示效果:







特殊符號轉(zhuǎn)譯

Markdown支持以下這些特殊字符通過在符號前面加上反斜杠來幫助插入普通的符號相种。

\   反斜線
`   反引號
*   星號
_   底線
{}  花括號
[]  方括號
()  括弧
#   井字號
+   加號
-   減號
.   英文句點
!   驚嘆號

顯示效果:

\ 反斜線

` 反引號

* 星號

_ 底線

{} 花括號

[] 方括號

() 括弧

# 井字號

+ 加號

- 減號

. 英文句點

! 驚嘆號

錨點

網(wǎng)頁中,錨點其實就是頁內(nèi)超鏈接,也就是鏈接本文檔內(nèi)部的某些元素寝并,實現(xiàn)當前頁面中的跳轉(zhuǎn)箫措。比如我這里寫下一個錨點,點擊回到目錄衬潦,就能跳轉(zhuǎn)到目錄斤蔓。在目錄中點擊這一節(jié),就能跳過來镀岛。還有下一節(jié)的注腳弦牡。這些根本上都是用錨點來實現(xiàn)的。

注意:

  1. Markdown Extra 只支持在標題后插入錨點漂羊,其它地方無效驾锰。
  2. Leanote 編輯器右側(cè)顯示效果區(qū)域暫時不支持錨點跳轉(zhuǎn),所以點來點去發(fā)現(xiàn)沒有跳轉(zhuǎn)不必驚慌走越,但是你發(fā)布成筆記或博文后是支持跳轉(zhuǎn)的椭豫。

代碼片段:

## 0. 目錄{#index}
***
***
此處省略一萬字
***
***
跳轉(zhuǎn)到[目錄](#index)

換行

普通換行

在行尾添加兩個空格加回車表示換行操作。

這是一行后面加了兩個空格后回車的  
換行

顯示效果:

這是一行后面加了兩個空格后回車的
換行

空行換行

在行尾連續(xù)兩次敲擊回車表示下一行空行并在第三行開始輸入操作旨指。

這是一行后面連續(xù)兩次敲擊回車的

空行換行

顯示效果:

這是一行后面連續(xù)兩次敲擊回車的

空行換行

腳注

腳注是寫文章時的一種格式:對正文中的某些問題需加以說明時赏酥,可用“呼應注”(也叫腳注),即在所要加注處的右上角標注“①谆构、②……”裸扶,同時在本頁末留出位置,劃一橫線與正文隔開搬素,在橫線下注明“①呵晨、②……”。

腳注的定義:

使用[^]來定義腳注蔗蹋。

腳注[^A]
[^A]: 這是一個腳注解釋內(nèi)容

顯示效果:

腳注[1]

常用彌補Markdown的Html標簽

字體
<font face="微軟雅黑" color="red" size="3">字體及字體顏色和大小</font>
<font color="#0000ff">字體顏色</font>

顯示效果:

<font face="微軟雅黑" color="red" size="3">字體及字體顏色和大小</font>
<font color="#0000ff">字體顏色</font>

換行
使用html標簽`<br/>`<br/>換行

顯示效果:

使用html標簽<br/>
換行

文本對齊方式
<p align="left">居左文本</p>
<p align="center">居中文本</p>
<p align="right">居右文本</p>

顯示效果:

<p align="left">居左文本</p>
<p align="center">居中文本</p>
<p align="right">居右文本</p>

下劃線
<u>下劃線文本</u>

顯示效果:

<u>下劃線文本</u>


  1. 這是一個腳注解釋內(nèi)容 ?

最后編輯于
?著作權歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
  • 序言:七十年代末何荚,一起剝皮案震驚了整個濱河市,隨后出現(xiàn)的幾起案子猪杭,更是在濱河造成了極大的恐慌,老刑警劉巖妥衣,帶你破解...
    沈念sama閱讀 216,402評論 6 499
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件皂吮,死亡現(xiàn)場離奇詭異,居然都是意外死亡税手,警方通過查閱死者的電腦和手機蜂筹,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 92,377評論 3 392
  • 文/潘曉璐 我一進店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來芦倒,“玉大人艺挪,你說我怎么就攤上這事”铮” “怎么了麻裳?”我有些...
    開封第一講書人閱讀 162,483評論 0 353
  • 文/不壞的土叔 我叫張陵口蝠,是天一觀的道長。 經(jīng)常有香客問我津坑,道長妙蔗,這世上最難降的妖魔是什么? 我笑而不...
    開封第一講書人閱讀 58,165評論 1 292
  • 正文 為了忘掉前任疆瑰,我火速辦了婚禮眉反,結(jié)果婚禮上,老公的妹妹穿的比我還像新娘穆役。我一直安慰自己寸五,他們只是感情好,可當我...
    茶點故事閱讀 67,176評論 6 388
  • 文/花漫 我一把揭開白布耿币。 她就那樣靜靜地躺著播歼,像睡著了一般。 火紅的嫁衣襯著肌膚如雪掰读。 梳的紋絲不亂的頭發(fā)上秘狞,一...
    開封第一講書人閱讀 51,146評論 1 297
  • 那天,我揣著相機與錄音蹈集,去河邊找鬼烁试。 笑死,一個胖子當著我的面吹牛拢肆,可吹牛的內(nèi)容都是我干的减响。 我是一名探鬼主播,決...
    沈念sama閱讀 40,032評論 3 417
  • 文/蒼蘭香墨 我猛地睜開眼郭怪,長吁一口氣:“原來是場噩夢啊……” “哼支示!你這毒婦竟也來了?” 一聲冷哼從身側(cè)響起鄙才,我...
    開封第一講書人閱讀 38,896評論 0 274
  • 序言:老撾萬榮一對情侶失蹤颂鸿,失蹤者是張志新(化名)和其女友劉穎,沒想到半個月后攒庵,有當?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體嘴纺,經(jīng)...
    沈念sama閱讀 45,311評論 1 310
  • 正文 獨居荒郊野嶺守林人離奇死亡,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點故事閱讀 37,536評論 2 332
  • 正文 我和宋清朗相戀三年浓冒,在試婚紗的時候發(fā)現(xiàn)自己被綠了栽渴。 大學時的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片。...
    茶點故事閱讀 39,696評論 1 348
  • 序言:一個原本活蹦亂跳的男人離奇死亡稳懒,死狀恐怖闲擦,靈堂內(nèi)的尸體忽然破棺而出,到底是詐尸還是另有隱情,我是刑警寧澤墅冷,帶...
    沈念sama閱讀 35,413評論 5 343
  • 正文 年R本政府宣布纯路,位于F島的核電站,受9級特大地震影響俺榆,放射性物質(zhì)發(fā)生泄漏感昼。R本人自食惡果不足惜,卻給世界環(huán)境...
    茶點故事閱讀 41,008評論 3 325
  • 文/蒙蒙 一罐脊、第九天 我趴在偏房一處隱蔽的房頂上張望定嗓。 院中可真熱鬧,春花似錦萍桌、人聲如沸宵溅。這莊子的主人今日做“春日...
    開封第一講書人閱讀 31,659評論 0 22
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽恃逻。三九已至,卻和暖如春藕施,著一層夾襖步出監(jiān)牢的瞬間寇损,已是汗流浹背。 一陣腳步聲響...
    開封第一講書人閱讀 32,815評論 1 269
  • 我被黑心中介騙來泰國打工裳食, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留矛市,地道東北人。 一個月前我還...
    沈念sama閱讀 47,698評論 2 368
  • 正文 我出身青樓诲祸,卻偏偏與公主長得像浊吏,于是被迫代替她去往敵國和親。 傳聞我的和親對象是個殘疾皇子救氯,可洞房花燭夜當晚...
    茶點故事閱讀 44,592評論 2 353