Markdown基本規則

Markdown基本規則

4 人贊了文章

介紹

Markdown是一種可以使用普通文本編輯器編寫的標記語言，通過簡單的標記語法，它可以使普通文本內容具有一定的格式。

1. 斜體和粗體示例

*斜體*或_斜體_ 要傾斜的文字左右分別用一個*號包起來**粗體** 要加粗的文字左右分別用兩個*號包起來***加粗斜體*** 要傾斜和加粗的文字左右分別用三個*號包起來~~刪除線~~ 要加刪除線的文字左右分別用兩個~~號包起來

顯示效果：

這是一段斜體這是一段粗體這是一段加粗斜體~~這是一段刪除線~~

2. 分級標題

第一種寫法：

這是一個一級標題 ============================ 這是一個二級標題 --------------------------------------------------

第二種寫法：

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

3. 超鏈接

Markdown 支持兩種形式的鏈接語法： 行內式和參考式兩種形式，行內式使用較多。

3.1. 行內式

語法說明：

[]里寫鏈接文字，()里寫鏈接地址, ()中的「」中可以為鏈接指定title屬性，title屬性可加可不加。>title屬性的效果是滑鼠懸停在鏈接上會出現指定的 title文字。鏈接文字』這樣的形式。鏈接地址與鏈接標題前有一個空格。

示例：

這是[超鏈接](https://www.baidu.com)這是[超鏈接](https://www.baidu.com "超鏈接")

顯示效果：

這是超鏈接這是超鏈接

3.2. 參考式

語法說明：

參考式鏈接分為兩部分，文中的寫法 [鏈接文字][鏈接標記]，在文本的任意位置添加[鏈接標記]:鏈接地址 「鏈接標題」，鏈接地址與鏈接標題前有一個空格。

如果鏈接文字本身可以做為鏈接標記，你也可以寫成[鏈接文字][]

[鏈接文字]：鏈接地址的形式，見代碼的最後一行。

示例：

我經常去的幾個網站[Google][1]、[Leanote][2]以及[百度][3][Leanote 筆記][2]是一個不錯的[網站][]。[1]:https://www.google.com "Google"[2]:https://www.leanote.com "Leanote"[3]:https://www.baidu.com "百度"[網站]:https://www.bilibili.com

顯示效果：

我經常去的幾個網站Google、Leanote以及百度Leanote 筆記是一個不錯的網站。

3.3. 自動鏈接

語法說明：

Markdown 支持以比較簡短的自動鏈接形式來處理網址和電子郵件信箱，只要是用<>包起來， Markdown 就會自動把它轉成鏈接。一般網址的鏈接文字就和鏈接地址一樣，例如：

示例：

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

顯示效果：http://example.com/address@example.com

4. 錨點

網頁中，錨點其實就是頁內超鏈接，也就是鏈接本文檔內部的某些元素，實現當前頁面中的跳轉。比如我這裡寫下一個錨點，點擊回到目錄，就能跳轉到目錄。 在目錄中點擊這一節，就能跳過來。還有下一節的註腳。這些根本上都是用錨點來實現的。

注意：

1. Markdown Extra 只支持在標題後插入錨點，其它地方無效。

1. Leanote 編輯器右側顯示效果區域暫時不支持錨點跳轉，所以點來點去發現沒有跳轉不必驚慌，但是你發布成筆記或博文後是支持跳轉的。

語法描述：

在你準備跳轉到的指定標題後插入錨點{#標記}，然後在文檔的其它地方寫上連接到錨點的鏈接。

示例：

目錄{#index}跳轉到[目錄](#index)

顯示效果：

跳轉到目錄

5. 列表

5.1. 無序列表

使用 *，+，- 表示無序列表。

示例：

* 無序列表項 一+ 無序列表項 二- 無序列表項 三

顯示效果：

* 無序列表項 一

+ 無序列表項 二

- 無序列表項 三

5.2. 有序列表

有序列表則使用數字接著一個英文句點。

示例：

1. 有序列表項 一2. 有序列表項 二3. 有序列表項 三

顯示效果：

1. 有序列表項 一

2. 有序列表項 二

3. 有序列表項 三

5.3. 一個特殊情況

在特殊情況下，項目列表很可能會不小心產生，像是下面這樣的寫法

1986. What a great season.

會顯示成：1986. What a great season

換句話說，也就是在行首出現數字-句點-空白，要避免這樣的狀況，你可以在句點前面加上反斜杠：

1986. What a great season

會顯示成：1986. What a great season.

6. 引用

語法說明：

引用需要在被引用的文本前加上>符號。

示例：

> 這是一個有兩段文字的引用,> 無意義的占行文字1.> 無意義的占行文字2.> 無意義的占行文字3.> 無意義的占行文字4.

顯示效果：

這是一個有兩段文字的引用,

無意義的占行文字1.

無意義的占行文字2.

無意義的占行文字3.

無意義的占行文字4.

6.1. 引用的多層嵌套

區塊引用可以嵌套（例如：引用內的引用），只要根據層次加上不同數量的 > ：

示例：

>>> 請問 Markdwon 怎麼用？ - 小白>> 自己看教程！ - 憤青> 教程在哪？ - 小白

顯示效果：

請問 Markdwon 怎麼用？ - 小白

自己看教程！ - 憤青

教程在哪？ - 小白

7. 插入圖像

圖片的創建方式與超鏈接相似，而且和超鏈接一樣也有兩種寫法，行內式和參考式寫法。

語法中圖片Alt的意思是如果圖片因為某些原因不能顯示，就用定義的圖片Alt文字來代替圖片。 圖片Title則和鏈接中的Title一樣，表示滑鼠懸停與圖片上時出現的文字。 Alt 和 Title 都不是必須的，可以省略，但建議寫上。

7.1. 行內式

語法說明：[圖片上傳失敗...(image-5b640-1533142208928)]

示例：

美麗花兒：![美麗花兒](http://upload-images.jianshu.io/upload_images/7973237-581e2f071ef21881.jpg?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240 "美麗花兒")

顯示效果：

美麗花兒：

7.2. 參考式

語法說明：

在文檔要插入圖片的地方寫![圖片Alt][標記]

在文檔的最後寫上[標記]:圖片地址 「Title」

示例：

美麗花兒：![美麗花兒][flower][flower]:http://ww2.sinaimg.cn/large/56d258bdjw1eugeubg8ujj21kw16odn6.jpg "美麗花兒"

顯示效果：

美麗花兒：

8. 註腳

語法說明：

在需要添加註腳的文字後加上腳註名字[^註腳名字],稱為加註。 然後在文本的任意位置(一般在最後)添加腳註，腳註前必須有對應的腳註名字。

注意：經測試註腳與註腳之間必須空一行，不然會失效。成功後會發現，即使你沒有把註腳寫在文末，經Markdown轉換後，也會自動歸類到文章的最後。

代碼：

使用 Markdown[^1]可以效率的書寫文檔, 直接轉換成HTML[^2], 你可以使用 Leanote[^Le] 編輯器進行書寫。[^1]:Markdown是一種純文本標記語言[^2]:HyperText Markup Language 超文本標記語言[^Le]:開源筆記平台，支持Markdown和筆記直接發為博文

顯示效果：

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

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

註：腳註自動被搬運到最後面，請到文章末尾查看，並且腳註後方的鏈接可以直接跳轉回到加註的地方。

9. LaTeX 公式

9.1. $ 表示行內公式

示例：

質能守恆方程可以用一個很簡潔的方程式 $E=mc^2$ 來表達。

顯示效果：

質能守恆方程可以用一個很簡潔的方程式 $E=mc^2$ 來表達。

9.2 $$ 表示整行公式

示例：

$$sum_{i=1}^n a_i=0$$$$f(x_1,x_x,ldots,x_n) = x_1^2 + x_2^2 + cdots + x_n^2 $$$$sum^{j-1}_{k=0}{widehat{gamma}_{kj} z_k}$$

顯示效果：

10. 流程圖

示例：

flowst=>start: 開始op=>operation: My Operationcond=>condition: Yes or No?e=>endst->op->condcond(yes)->econd(no)->op&

顯示效果：

flow

st=>start: 開始

op=>operation: My Operation

cond=>condition: Yes or No?

e=>end

st->op->cond

cond(yes)->e

cond(no)->op

&

更多語法參考：流程圖語法參考

11 .表格

語法說明：

不管是哪種方式，第一行為表頭，第二行分隔表頭和主體部分，第三行開始每一行為一個表格行。

列於列之間用管道符|隔開。原生方式的表格每一行的兩邊也要有管道符。

第二行還可以為不同的列指定對齊方向。默認為左對齊，在-右邊加上:就右對齊。

示例：

| 項目 | 價格 | 數量 || -------- | -----: | :----: || 計算機 | $1600 | 5 || 手機 | $12 | 12 || 管線 | $1 | 234 |First Header | Second Header------------- | -------------Content Cell | Content CellContent Cell | Content Cell| First Header | Second Header || ------------- | ------------- || Content Cell | Content Cell || Content Cell | Content Cell || Function name | Description || ------------- | ------------------------------ || `help()` | Display the help window. || `destroy()` | **Destroy your computer!** || Left-Aligned | Center Aligned | Right Aligned || :------------ |:---------------:| -----:|| col 3 is | some wordy text | $1600 || col 2 is | centered | $12 || zebra stripes | are neat | $1 || Item | Value || --------- | -----:|| Computer | $1600 || Phone | $12 || Pipe | $1 |

顯示效果：

12. 分隔線

你可以在一行中用三個以上的星號、減號、底線來建立一個分隔線，行內不能有其他東西。你也可以在星號或是減號中間插入空格。下面每種寫法都可以建立分隔線：

代碼：

* * *********- - ----------------------------------------

顯示效果：

---

---

---

- - -

13. 代碼

對於程序員來說這個功能是必不可少的，插入程序代碼的方式有兩種，一種是利用縮進(Tab), 另一種是利用」`」符號（一般在ESC鍵下方）包裹代碼。

語法說明：

插入行內代碼，即插入一個單詞或者一句代碼的情況，使用code這樣的形式插入。

插入多行代碼，可以使用縮進或者「code 「,具體看示例。

注意： 縮進式插入前方必須有空行

13.1. 行內式

示例：

C語言里的函數 `scanf()` 怎麼使用？

顯示效果：

C語言里的函數 scanf() 怎麼使用？

13.2. 縮進式多行代碼

縮進 4 個空格或是 1 個製表符

一個代碼區塊會一直持續到沒有縮進的那一行（或是文件結尾）。

示例：

#include intmain(void) { printf("Hello world
"); }

顯示效果：

#include

intmain(void)

{

printf("Hello world
");

}

13.3. 用六個`包裹多行代碼

示例：

(~~~)#includeintmain(void){ printf("Hello world
");}(~~~)注意：括弧是不需要的

顯示效果：

#includeintmain(void){ printf("Hello world
");}

13.4. HTML 原始碼

在代碼區塊裡面， & 、 < 和 > 會自動轉成 HTML 實體，這樣的方式讓你非常容易使用 Markdown 插入範例用的 HTML 原始碼，只需要複製貼上，剩下的 Markdown 都會幫你處理

示例：

&copy; 2004 Foo Corporation&lt;標題&gt;<font color="red">標籤內添加Html是沒有效果的哦</font>

顯示效果：

? 2004 Foo Corporation

<標題>This is some text!

推薦閱讀：