超好用Markdown編輯器Typora: Markdown Reference (Typora下Markdown語法使用說明)

引言

• 由於一直在使用Typora，這個是我使用過的最棒的Markdown編輯器，但是總是忽略某一個功能，於是決定認真看一下其幫助文檔
• 這里做一個簡單主要功能的中文翻譯(按鍵對應Windows下)。
• 原文鏈接→傳送門，感謝作者。

update

• 自定義快捷鍵

標題(Headers)

• 標題的書寫方式為:在行的開頭用1~6個#,來對應表示標題1到標題6

# 這是一級標題
## 這是二級標題
### 這是三級標題

• 在Typora中，輸入#之后直接輸入內容，再按Enter鍵，將會創建一個標題。或者按Ctrl+1(1_{6)創建一級標題（1}6級標題），或者在輸入行右擊→段落→對應標題。

引用(Blockquotes)

• Markdown使用>字符來表示塊的引用，具體如下：

> 這是兩段的引用，這是第一段
>
> 這是第二段

> 這是另外一段只有一段的引用。兩個引用之間有三個空行用來分割不同的引用。

• 在Typora中，輸入>，隨后輸入內容，即可生成一個引用。Typor將會為你插入正確的>或者分割線。嵌套的塊引用（一個塊引用在另一個塊引用中）的情況，可以在引用中添加額外的>來區分表示。

列表(Lists)

• 輸入*(或者-/+)，和一個空格，將會產生一個無序列表。
• 輸入1.和一個空格，將會產生一個有序列表。
• 例如：

## 無序列表
- 紅
- 綠
- 藍

## 有序列表
1. 紅
2. 綠
3. 藍

任務列表(Task List)

• 任務列表是用來表示任務是否完成的（- [ ]:未完成，- [x]已經完成）
• 示例：

- [ ] 未完成任務項
- [x] 已經完成任務項

• 可以通過點擊復選框來改變是否完成的狀態
• 經過我的試驗，直接在Typora中輸入- [ ]來觸發顯示復選框，不太容易實現（因為總是會先解析-為無序列表），建議右擊，點擊來實現。

代碼塊((Fenced) Code Blocks)

• Typora僅在Github Flavored Markdown中支持柵欄樣式，並不是代碼的原始樣式。
• 使用柵欄格式的代碼塊很簡單：輸入```,按下Enter鍵,隨后可以在柵欄右下角選擇對應的代碼語言。也可以在```后面輸入代碼語言名字（python等）。之后就會有對應的語法高亮。
• 示例：
  

數學公式(Math Blocks)

• 可以使用MathJax渲染LaTex數學表達式
• 輸入$$，按Enter鍵來添加數學公式。這將會觸發一個輸入框，該框內可以輸入Tex/LaTex源碼，例如如下公式：
  
• 其源碼為：

$$
\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)

• 輸入| First Header | Second Header |, 按下Enter鍵。將會生成一個兩列的表格。
• 當產生一個表格后，將鼠標放在表格上，，將會在表格上方產生一個工具框，可以通過它來設置表格大小，對齊單元格或者刪除表格。也可以使用context菜單來刪除或添加一行/一列。
• 全部的表格語法見下方，這並不是必須知道的。可以通過右擊→插入→表格,其他的Typora會自動生成。

| First Header  | Second Header |
| ------------- | ------------- |
| Content Cell  | Content Cell  |
| Content Cell  | Content Cell  |

• 同時可以對表格中某個單元格字體設置加粗、斜體或者刪除線等
• 通過在標題行下面添加：，來設置該列是左對齊、右對齊或者居中

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

腳注(Footnotes)

• 具體腳注添加方法如下：

You can create footnotes like this[^fn1] and this[^fn2].

[^fn1]: Here is the *text* of the first **footnote**.
[^fn2]: Here is the *text* of the second **footnote**.

• 鼠標放在'fn1'或者'fn2'上，可以看到腳注的內容。可以使用任何標識符來標明是腳注。
• 可以創建內嵌腳注，像this^[1]（這個沒有看太懂-_-）

橫線（分割線）(Horizontal Rules)

• 在空白行輸入***或者---，按Enter鍵將會畫一個橫分割線。

YAML Front Matter

• 在文章頂部，輸入---，按下Enter鍵，即可產生metadata塊。
• 當然也可以右擊→插入→YAML Front Matter。

目錄(Table of Contents (TOC))

• 輸入[TOC]，按下Enter鍵，將會將文中的標題按照層級生成目錄，並且自動更新

跨度元素（Span Elements）

跨度元素在鍵入后立即將解析並渲染。並且將光標放在Span Elements中間時，將會自動顯示為Markdown源碼。

超鏈接(Links)

Markdown支持兩種格式超鏈接：內嵌式和參考式。

內嵌式超鏈接（Internal Links）

• 內嵌式超鏈接可以看作一個頁內書簽，類似於Word中對圖表的交叉引用
• 按住Ctrl，左鍵點擊相應鏈接，就可以跳到相應標題下。

Hold down Cmd (on Windows: Ctrl) and click on [this link](#block-elements) to jump to header `Block Elements`. 

參考式超鏈接(Reference Links)

• 這個比較常用，就是給指定文字添加超鏈接
• 具體寫法如下：

這個一個[參考式超鏈接](http://example.com/ "標題")的例子

• 在Typora中，單擊這個超鏈接，將會為可編輯的超鏈接的源碼。按住Ctrl+左鍵單擊將會使用默認瀏覽器打開這個超鏈接。

URL

• 在Typora中，可以在<>中放入URL,例如[e-mail],就會被解析為帶有下划線的[e-mail]

圖像(Images)

• 圖像的插入和插入超鏈接有着相似的語法，但是插入圖像要求在圖像鏈接前插入一個額外的!，插入語法類似於如下：

![描述文本(可選)](/path/to/img.jpg)

![描述文本(可選)](/path/to/img.jpg "標題")

• 在Typora中，可以采取拖曳方式從本地或者瀏覽器上插入圖像，也可以通過點擊圖像來修改圖像路徑。如果添加的圖像所在路徑和編輯文件為同一目錄，則圖像的路徑為相對路徑。
• 如果使用Markdown來構建網站，可以通過YAML Front Matter中添寫typora-root-url來指定本地圖像的前綴。
• 例如：在YAML Front Matter中輸入typora-root-url:/User/Abner/Website/typora.io/，之后插入圖像，在Typora中將會變為。

強調(Emphasis)

• Markdown中將*和_作為強調的標志符號。如果文本用*或者_包圍，則會被解析為HTML中的,例如：

*single asterisks*
_single underscores_

結果如下：
single asterisks
single underscores

• 如果想要用*和_,則可以在*和_加\
• Typora中推薦使用*。

加粗(Strong)

• 兩個**或者__包圍的文本將會對其加粗，解析為HTML中的標簽
• 例如：

**double asterisks**
__double underscores__

• 結果如下：
  double asterisks
  double underscores

• Typora中推薦使用**

代碼(Code)

• 為了表明行間的代碼，使用``將其包圍。
• 例子：
  

刪除線(Strikethrough)

• 兩個~~將文本包圍，將會產生刪除線
  

Emoji:happy

• 輸入:將會觸發Emoji表情。
• 例如， :happy:將會產生

行內公式(Inline Math)

• 如果想要使用該功能，需要先設置為能用，如下：
  
• 使用$來包圍要寫的公式，例如：
• 為了觸發行內公式的預覽，可以先輸入'$',按ESC鍵。
• 了解詳情

下角標/上角標/高亮

• 下角標：H₂O
• 上角標：X²
• 高亮：highlight

HTML

• 可以通過添加HTML來添加Markdown不支持的格式。
• 例如：

 <span style="color:red">this text is red</span> 

下划線

• 下划線在GFM的Markdown中並不支持，但是可以通過HTML來添加
• 例如：
  

嵌入內容(Embed Contents)

• 一些網站提供基於iframe的嵌入代碼，您也可以將其粘貼到Typora中。
• 例如,將以下代碼粘貼到文本中：

<iframe height='265' scrolling='no' title='Fancy Animated SVG Menu' src='http://codepen.io/jeangontijo/embed/OxVywj/?height=265&theme-id=0&default-tab=css,result&embed-version=2' frameborder='no' allowtransparency='true' allowfullscreen='true' style='width: 100%;'></iframe>

• 結果如下：
  

視頻(Video)

• 可以通過插入<video>的HTML標簽來嵌入視頻，也可以直接拖曳。
• 例如：

<video src="xxx.mp4"/>

• 結果如下：
  

其它支持的HTML

• 參考鏈接

---

寫在最后：本文涉及到的大部分Markdown語法都是通用的，本文使用的就是Markdown編輯器寫成的。文中如果有什么問題，可以指出。

---

1. Here is the text of the first footnote. ↩︎