1. 程式人生 > 實用技巧 >Markdown語法

Markdown語法

參考自菜鳥教程Markdown語法

Markdown標題

使用#號表示

使用 # 號可表示 1-6 級標題,一級標題對應一個 # 號,二級標題對應兩個 # 號,以此類推。

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

Markdown段落格式

段落

Markdown 段落沒有特殊的格式,直接編寫文字就好,段落的換行是在末尾使用兩個以上空格加上回車。

當然也可以在段落後面使用一個空行來表示重新開始一個段落。

字型

Markdown 可以使用以下幾種字型:

*斜體文字*
_斜體文字_
**粗體文字**
__粗體文字__
***粗斜體文字***
___粗斜體文字___

分割線

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

***

* * *

*****

- - -

----------

刪除線

如果段落上的文字要新增刪除線,只需要在文字的兩端加上兩個波浪線 ~~ 即可,例項如下:
~~abcde~~ abcdefg

下劃線

下劃線可以通過 HTML 的 <u>標籤來實現:

<u>帶下劃線文字</u>

帶下劃線文字

腳註

腳註是對文字的補充說明。

Markdown 腳註的格式如下:

[^要註明的文字]

建立腳註格式類似這樣[1]

Markdown列表

Markdown 支援有序列表和無序列表。

無序列表使用星號(*)、加號(+)或是減號(-)作為列表標記,這些標記後面要新增一個空格,然後再填寫內容:

* 第一項
* 第二項
* 第三項

+ 第一項
+ 第二項
+ 第三項


- 第一項
- 第二項
- 第三項

顯示結果如下:

  • 第一項
  • 第二項
  • 第三項
  • 第一項
  • 第二項
  • 第三項
  • 第一項
  • 第二項
  • 第三項

有序列表使用數字並加上 . 號來表示,如:

1. 第一項
2. 第二項
3. 第三項
  1. 第一項
  2. 第二項
  3. 第三項

列表巢狀

列表巢狀只需在子列表中的選項前面新增四個空格即可:

1. 第一項:
    - 第一項巢狀的第一個元素
    - 第一項巢狀的第二個元素
2. 第二項:
    - 第二項巢狀的第一個元素
    - 第二項巢狀的第二個元素

結果顯示如下:

  1. 第一項:
    • 第一項巢狀的第一個元素
    • 第一項巢狀的第二個元素
  2. 第二項:
    • 第二項巢狀的第一個元素
    • 第二項巢狀的第二個元素

Markdown區塊

Markdown 區塊引用是在段落開頭使用 > 符號 ,然後後面緊跟一個空格符號:

> 區塊引用
> hello
> 你好

顯示如下:

區塊引用
hello
你好

另外區塊是可以巢狀的,一個 > 符號是最外層,兩個 > 符號是第一層巢狀,以此類推:

> 最外層
> > 第一層巢狀
> > > 第二層巢狀

顯示結果如下:

最外層

第一層巢狀

第二層巢狀

>>>你好

顯示結果如下:

你好

區塊中使用列表

> 區塊中使用列表
> 1. 第一項
> 2. 第二項
> + 第一項
> + 第二項
> + 第三項

顯示如下:

區塊中使用列表

  1. 第一項
  2. 第二項
  • 第一項
  • 第二項
  • 第三項

列表中使用區塊

如果要在列表專案內放進區塊,那麼就需要在 > 前新增四個空格的縮排。

區塊中使用列表例項如下:

* 第一項
    > hello
    > 天天向上
* 第二項

顯示如下:

  • 第一項

    hello
    天天向上

  • 第二項

Markdown程式碼

如果是段落上的一個函式或片段的程式碼可以用反引號把它包起來(`),例如:

`printf()`函式

顯示結果:

printf()函式

程式碼區塊

程式碼區塊使用 4 個空格或者一個製表符(Tab 鍵)。

也可以用 ``` 包裹一段程式碼,並指定一種語言(也可以不指定):

```javascript
$(document).ready(function () {
    alert('RUNOOB');
});   
\`\`\`   

顯示如下:

$(document).ready(function () {
    alert('RUNOOB');
});

Markdown連結

連結使用方法如下:

[連結名稱](連結地址)

或者

<連結地址>

eg:

[這是一個連結](https://www.baidu.com)   
<https://www.baidu.com>

顯示如下:
這是一個連結
https://www.baidu.com

高階連結

我們可以通過變數來設定一個連結,變數賦值在文件末尾進行:

這個連結用 1 作為網址變數 [Google][1]
這個連結用 runoob 作為網址變數 [Runoob][runoob]
然後在文件的結尾為變數賦值(網址)

  [1]: http://www.google.com/
  [runoob]: http://www.runoob.com/

這個連結用 1 作為網址變數 Google
這個連結用 runoob 作為網址變數 Runoob
然後在文件的結尾為變數賦值(網址)

Markdown圖片

Markdown 圖片語法格式如下:

![alt 屬性文字](圖片地址)

![alt 屬性文字](圖片地址 "可選標題")   
  • 開頭一個感嘆號 !
  • 接著一個方括號,裡面放上圖片的替代文字
  • 接著一個普通括號,裡面放上圖片的網址,最後還可以用引號包住並加上選擇性的 'title' 屬性的文字。

例項:

![RUNOOB 圖示](http://static.runoob.com/images/runoob-logo.png)

![RUNOOB 圖示](http://static.runoob.com/images/runoob-logo.png "RUNOOB")

顯示如下:

也可以像網址那樣對圖片網址使用變數:

這個連結用 2 作為網址變數 [RUNOOB][2].
然後在文件的結尾為變數賦值(網址)

[2]: http://static.runoob.com/images/runoob-logo.png

這個連結用 2 作為網址變數 RUNOOB.
然後在文件的結尾為變數賦值(網址)

Markdown 還沒有辦法指定圖片的高度與寬度,如果你需要的話,你可以使用普通的 <img> 標籤。

<img src="http://static.runoob.com/images/runoob-logo.png" width="50%">

顯示如下:

Markdown表格

Markdown 製作表格使用 | 來分隔不同的單元格,使用 - 來分隔表頭和其他行

語法格式如下:

|  姓名   |  性別  |  年齡  |
|  ----  |  ----  |  ---- |
| 單元格  | 單元格 | 單元格 |
| 單元格  | 單元格 | 單元格 |

顯示如下:

姓名 性別 年齡
單元格 單元格 單元格
單元格 單元格 單元格

對齊方式

我們可以設定表格的對齊方式:

  • -: 設定內容和標題欄居右對齊。
  • :- 設定內容和標題欄居左對齊。
  • :-: 設定內容和標題欄居中對齊。

例項:

| 左對齊 | 右對齊 | 居中對齊 |
| :-----| ----: | :----: |
| 單元格 | 單元格 | 單元格 |
| 單元格 | 單元格 | 單元格 |

顯示如下:

左對齊 右對齊 居中對齊
單元格 單元格 單元格
單元格 單元格 單元格

Markdown高階技巧

支援HTML元素

不在 Markdown 涵蓋範圍之內的標籤,都可以直接在文件裡面用 HTML 撰寫。

目前支援的 HTML 元素有:<kbd> <b> <i> <em> <sup> <sub> <br>等 ,如:

使用 <kbd>Ctrl</kbd>+<kbd>Alt</kbd>+<kbd>Del</kbd> 重啟電腦

顯示如下:

使用 Ctrl+Alt+Del 重啟電腦

轉義

Markdown 使用了很多特殊符號來表示特定的意義,如果需要顯示特定的符號則需要使用轉義字元,Markdown 使用反斜槓轉義特殊字元:

**文字加粗** 
\*\* 正常顯示星號 \*\*

顯示如下:

文字加粗
** 正常顯示星號 **

Markdown 支援以下這些符號前面加上反斜槓來幫助插入普通的符號:

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

公式

當你需要在編輯器中插入數學公式時,可以使用兩個美元符 $$ 包裹 TeX 或 LaTeX 格式的數學公式來實現。提交後,問答和文章頁會根據需要載入 Mathjax 對數學公式進行渲染。如:

$$
\mathbf{V}_1 \times \mathbf{V}_2 =  \begin{vmatrix} 
\mathbf{i} & \mathbf{j} & \mathbf{k} \\
\frac{\partial X}{\partial u} &  \frac{\partial Y}{\partial u} & 0 \\
\frac{\partial X}{\partial v} &  \frac{\partial Y}{\partial v} & 0 \\
\end{vmatrix}
${$tep1}{\style{visibility:hidden}{(x+1)(x+1)}}
$$

輸出顯示如下:

$$
\mathbf{V}_1 \times \mathbf{V}_2 = \begin{vmatrix}
\mathbf{i} & \mathbf{j} & \mathbf{k} \
\frac{\partial X}{\partial u} & \frac{\partial Y}{\partial u} & 0 \
\frac{\partial X}{\partial v} & \frac{\partial Y}{\partial v} & 0 \
\end{vmatrix}
${$tep1}{\style{visibility:hidden}{(x+1)(x+1)}}
$$


  1. 這是一個腳註! ↩︎