最近發現了 Markdown 這種從來沒有接觸過的寫作方式，看起來很厲害的樣子。於是用了一個週末的時間研究了好幾個 Markdown 寫作軟體，如Markdown 2，Yu writer，Typora等，綜合對比 Typora 最符合我的口味，該軟體目前還在內測階段，有Mac，Windows 和 Linux 版本。

Typora 官網 -> https://typora.io/

Typora 官方文件 -> https://support.typora.io/

        下面的程式碼是根據 Markdown Reference 學習的原始碼，由於 CSDN 的 Markdown 與 Typora 有所出入，所以此處就不貼出 Typora-learning.md 檔案，感興趣的童鞋可以到博主 GitHub 目錄下檢視/下載相應資料：

        https://github.com/fhqfghgdx/Markdown-Learning

        小白上路，大神輕噴！^_^

[TOC]

# Block Elements

## Paragraph and line breaks

一個段落只是一個或多個連續的文字行。在Markdown原始碼中，段落由多個空行分隔。在Typora中，您只需按回車即可建立一個新段落。

按下Shift + Enter 可建立一個換行符。但是，大多數markdown解析器會忽略單行換行，讓其他markdown解析器識別您的換行符，您可以在行末留出兩個空格，或者插入<br/>

## Headers

建立一級到六級標題

```markdown
# 標題1
## 標題2
...
###### 標題6
```

快捷鍵：

![標題快捷鍵](E:\OneDrive\GitHub\Markdown-Learning\Picture\標題快捷鍵.png)



## Blockquotes

使用 '>' 符號

```markdown
> This is a blockquote with two paragraphs. This is first paragraph.
```

> This is a blockquote with two paragraphs. This is first paragraph.
>
> This is second pragraph.Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, risus.
>
> This is another blockquote with one paragraph. There is three empty line to seperate two blockquote.
>
> 在引用中再次引用
>
> > 二級引用第一段
> >
> > 二級引用第二段
> >
> > > 三級引用第一段
> > >
> > > ...

原始碼：

```markdown
> This is a blockquote with two paragraphs. This is first paragraph.
>
> This is second pragraph.Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, risus.
>
> This is another blockquote with one paragraph. There is three empty line to seperate two blockquote.
>
> 在引用中再次引用
>
> > 二級引用第一段
> >
> > 二級引用第二段
> >
> > > 三級引用第一段
> > >
> > > ...
```



## Lists

無序列表：使用 '*'，'+'，'-'

有序列表：使用 '1.'，'2.'，...

### un-ordered list

+ Red
  + Green
    + Block
  + Yellow
    + Blue

原始碼：

```markdown
+ Red
  + Green
    + Block
  + Yellow
    + Blue
```

**注： 快捷鍵 Ctrl + / 切換檢視為原始碼模式**



### ordered list

1. Red
   1. Green
      1. Block
   2. Yellow
      1. Blue

原始碼：

```markdown
1. Red
   1. Green
      1. Block
   2. Yellow
      1. Blue
```



## Task list

建立任務列表形式的條目

- [x] A task list item
- [ ] list syntax required
  - [ ] normal **formatting** , @mentions, #1234 refs
  - [x] incomplete
  - [ ] complete

原始碼：

```markdown
- [x] A task list item
- [ ] list syntax required
  - [ ] normal **formatting** , @mentions, #1234 refs
  - [x] incomplete
  - [ ] complete
```



## (Fenced) Code Blocks

Typora 僅支援 GitHub 格式的程式碼塊，而不支援 Markdown 原始程式碼塊的格式。

使用 Fence 建立程式碼塊：使用連續的三個 '```',Typora 將把其之後的行解析成程式碼塊。

```markdown
Code block line 1
```

設定程式碼塊語言：'```Python'

```python
import Serial
...
```



## Math Blocks

建立公式：兩個連續的 '$$'

Input `$$`, then press ‘Return’ key will trigger an input field which accept *Tex/LaTex* source.  
$$
\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}
$$

原始碼：

```markdown
$$
\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}
$$
```



## Tables

Input `| First Header  | Second Header |` and press `return` key will create a table with two column. 

### 使用原始碼格式建立表格:

切換到Markdown原始碼檢視輸入下面的程式碼塊

```markdown
| Left-Aligned  | Center Aligned  | Right Aligned |
| :------------ |:---------------:| -----:|
| col 3 is      | some wordy text | $1600 |
| col 2 is      | centered        |   $12 |
| zebra stripes | are neat        |    $1 |
```

再切換回標準檢視可以看到如下表格

| Left-Aligned  | Center Aligned  | Right Aligned |
| :------------ |:---------------:| -----:|
| col 3 is      | some wordy text | $1600 |
| col 2 is      | centered        |   $12 |
| zebra stripes | are neat        |    $1 |

### 使用 Typora 快速建立表格

**快捷鍵：Ctrl + T**，可以快速設定對齊方式，而不是使用 ':' 與 '-' 結合的方法

|      |      |      |
| ---- | ---- | ---- |
|      |      |      |
|      |      |      |
|      |      |      |



## Footnotes

You can create footnates like this[^1] and that[^2] .

[^1]: Here is the *this* of the **footnote**
[^2]: Here is the *that* of the **footnote**

原始碼：

```markdown
You can create footnates like this[^1] and that[^2] .

[^1]: Here is the *this* of the **footnote**
[^2]: Here is the *that* of the **footnote**
```



## Horizontal Rules

建立水平分割線：'***' 或 '---'

例如：

***

---

原始碼：

```
***

---
```



## YAML Front Matters

Typora support [YAML Front Matters](https://jekyllrb.com/docs/frontmatter/) now. Input `---` at the top of the article and then press `Enter` will introduce one. Or insert one metadata block from the menu. 

**注：快捷鍵 Ctrl + Shift + L 隱藏/顯示側邊欄**



## Table of Contents(TOC)

輸入 '[toc]' 按 enter 鍵會生成本文件的目錄

**切換到原始碼模式，可以看到本文在開頭添加了 `[TOC]`，用於生成本文的目錄結構，且隨著文章修改而自動更新**



# Span Element

## Links

Markdown 支援兩種型別的 links: inline 和 reference

兩種模式的連結名稱都使用 [] 包含

This is [an example](https://www.baidu.com "百度一下") inline link.
[This link](https://www.baidu.com) has no title attribute.

原始碼：

```markdown
This is [an example](https://www.baidu.com "百度一下") inline link.
[This link](https://www.baidu.com) has no title attribute.
```

### Internal Links(內部引用)

Command(on Windows: Ctrl) + Click [This link](https://support.typora.io/Markdown-Reference/#block-elements) will jump to header `Block Elements`. To see how to write that, please move cursor or click that link with `⌘` key pressed to expand the element into markdown source. 

### Reference Links

可以先建立一個連線，[] 中的內容用一個“變數”代替，然後在本文章的任意位置均可以對該“變數”進行賦值，設定其網址和標題，如下：

This is [an example][id] reference-style link.

Then, anywhere in the document, you define your link label like this, on a line by itself:

[id]: http://example.com/  "Optional Title Here"

原始碼：

```markdown
This is [an example][id] reference-style link.

Then, anywhere in the document, you define your link label like this, on a line by itself:

[id]: http://example.com/  "Optional Title Here"
```

也可以將中括號內空出來，僅使用連線名稱作為“變數”去賦值：

[Baidu][]

And then difine the link:

[Baidu]:http://www.baidu.com/

原始碼：

```markdown
[Google][]
And then define the link:
[Google]:http://google.com
```



## URLs

Typora 可以插入 URLs 作為連結，由 <> 包含

`<
 
[email protected]>` becomes [[email protected]](mailto:[email protected]). 

`<baidu>`的地址是：www.baidu.com



## Images

### 快捷鍵 Ctrl + Shift + I

手動編輯 `![xxx](//path)`或使用快捷鍵 Ctrl + Shift + I

![藍色經典](E:\OneDrive\GitHub\Markdown-Learning\Picture\藍色經典.jpg)

原始碼：

```markdown
![藍色經典](E:\OneDrive\GitHub\Markdown-Learning\Picture\藍色經典.jpg)
```

### 直接將圖片拖進文章

此方式將自動地建立圖片的連結資訊

![wallhaven-133008](E:\OneDrive\GitHub\Markdown-Learning\Picture\wallhaven-133008.jpg)

原始碼：

```markdown
![wallhaven-133008](E:\OneDrive\GitHub\Markdown-Learning\Picture\wallhaven-133008.jpg)
```



## Emphasis

設定斜體突出顯示，快捷鍵：Ctrl + I，或手輸 `*xxx*` 或 `_xxxx_`

*single asterisks*

_single underscores_

原始碼:

```markdown
*single asterisks*

_single underscores_
```

**注：若需要使用`*`等特殊符號作為文字顯示，則需要使用`\`對其進行轉義**



## Strong

設定粗體突出顯示，快捷鍵：Ctrl + B，或手輸`**xxxx**`



## Code

`` `符號用於程式碼引用

**注：在行內的程式碼塊引用使用兩個`` ` 包含文字，如：**

```markdown
`code`
``code``
```



## Strikethrough

為文字新增刪除線，使用`Shift` + `` `鍵，在文字兩端新增 '~~' 符號

`Mistaken text.` becomes ~~Mistaken text~~

原始碼：

```markdown
`Mistaken text.` becomes ~~Mistaken text~~
```



## Underlines

為文字新增下劃線：`<u>xxx</u>`

`<u>Underline</u>` becomes <u>Underline</u>.

原始碼：
```markdown
`<u>Underline</u>` becomes <u>Underline</u>.
```



## Emoji:happy:

`smile` -> :smile:

`satified`-> :satisfied:

......

原始碼：

```markdown
`smile` -> :smile:

`satified`-> :satisfied:
```



**以下功能需要開啟 Markdown 擴充套件功能，在 Typora 中設定路徑：**

**檔案->偏好設定->Markdown擴充套件語法->全部勾選**

![Markdown擴充套件語法](E:\OneDrive\GitHub\Markdown-Learning\Picture\Markdown 擴充套件語法.png)



## Inline Math

$\lim_{x \to \infty} \exp(-x) = 0$

原始碼：

```
$\lim_{x \to \infty} \exp(-x) = 0$
```



## Subscript

下標設定：使用`~`包含下標文字

H~2~O

X~long~

原始碼：

```markdown
H~2~O

X~long~
```



## Superscript

上標設定：使用`^`包含上標文字

X^2^

原始碼：

```markdown
X^2^
```



## Highlight

高亮設定：使用`==`包含高亮文字

Here is the *test* of ==footnote.==

原始碼：

```markdown
Here is the *test* of ==footnote.==
```