Typora自帶了其語法的英文版幫助文檔，試着翻譯成了中文，順便也可以練一下Typora的使用。
Typora中的Markdown語法
概述
Markdown 的原始指引發布在Daring Fireball博客1，你可點擊這裏查看。在不同的解析器或編輯器中，使用的Markdown語法並不完全相同。Typora使用GitHub Flavored Markdown2作爲其語法標準。
文章目錄
塊元素
段落與換行
在Markdown語法中，一個字或者連續的文字都可以作爲一個段落。一個段落結束後，最少需要按兩次Enter（回車鍵）纔可以創建下一個段落。而通過Typora，你只需要按一次Enter（回車鍵）就可以創建新段落。
在普通的文本編輯器中，回車鍵用於換行，但在Typora中，回車鍵用於創建一個新段落，所以如果你需要在Typora中的一個段落內進行換行，可以通過輸入Shift+Enter實現。爲了避免段內換行在其他markdown編輯器解析時被忽略，可在段落內每行的最後，輸入兩個空格或者<br/>符號。
標題
在Markdown語法中，一行的開頭輸入#字符號代表這一行是標題。最多可以輸入6個，對應1~6級標題。例如：
# 這是一級標題
## 這是二級標題
###### 這是六級標題
同樣的，在Typora中，輸入’#'符號，然後輸入內容3，按下Enter（回車鍵）後，軟件會將這段內容設置爲標題格式。
引用
Markdown 語法使用電子郵件風格的>字符代表引用。像下面這樣表達:
> 這個引用有兩個段落，這是第一個段落。
>
> 這是第二個段落。原文內容，也許，只是一些，隨便寫的，示意信息吧。
>這是另一個只有一個段落的引用。與上一個引用間用三個空白行進行了分隔。
在Typora的空白行中，先輸入’>‘然後輸入內容，會將內容設置爲引用格式。如果此時回車創建下一行，Typora也會將下一行自動設置爲引用格式(可以再按一次回車鍵取消)。再引用裏面，可以繼續輸入’>'實現嵌套引用。
列表
輸入* 列表內容將會創建一個無序列表，也可以用+號或者-號實現同樣效果。
輸入1. 列表內容將創建一個有序列表，markdown語法如下：
## 無序列表
* 紅
* 綠
* 藍
## 有序列表
1. 紅
2. 綠
3. 藍
任務列表
在列表語法的基礎下，輸入[ ]或者[x] (未完成或者完成)可創建帶複選框的任務列表。語法如下：
- [ ] 任務1
- [ ] 任務2
- [ ] 任務3
- [ ] 任務4
- [x] 任務5
創建任務列表後，你可以通過直接點擊複選框改變其狀態。
代碼塊
Typora中代碼塊的語法按照GitHub Flavored Markown2，不支持原始Markdown代碼塊語法。
使用代碼塊的方法很簡單：輸入```按下Enter回車鍵，然後可以輸入語法名稱進行語法定義，也可以不進行語法定義而直接開始編寫內容，在內容的結尾輸入```結束文本塊編輯。如果進行了語法定義，軟件會根據語法定義對文本塊內的一些元素進行高亮顯示:
這是一個示例:
下面例子未進行語法定義：
```
function test() {
console.log("notice the blank line before this function?");
}
```
下面例子將語法定義爲ruby，軟件顯示文本塊時會對一些元素進行高亮：
syntax highlighting:
```ruby
require 'redcarpet'
markdown = Redcarpet.new("Hello World!")
puts markdown.to_html
```
你可以將上列例子複製到Typora中查看對應的效果。
公式塊
Typora通過MathJax顯示LaTeX4格式的數學公式。
輸入$$然後按下Enter回車鍵，可以觸發數學公式輸入界面，在界面中輸入Tex/LaTex源碼後，將會顯示對應的數學公式。例子：
軟件會自動創建兩組’$$'符號，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}
$$
你可以點擊這裏查閱更多的相關內容。
表格
輸入|列標題1|列標題2|然後按下Enter回車鍵後，將會創建一個兩列的表格。
表格創建後，當輸入光標在表格內時，表格上方會出現用於調整表格格式或刪除表格的功能欄。你也可以通過Typora上方的菜單欄(段落->表格)對錶格進行復制或者增減行列。
下方的示意是完整的表格輸入語法，但在Typora中，你只要知道第一行的生成方法就可以了，剩下的都可以通過軟件自動補全。
在Markdown源代碼中，表格的語法是這樣的：
| 列標題1 | 列標題2 |
| ------ | ------ |
| 單元格 | 單元格 |
| 單元格 | 單元格 |
你也可以使用Markdown語法修飾表格內部的元素，例如鏈接、加粗，斜體，刪除線。
在Markdown源碼模式中，可以發現表格是通過(:)號實現列的左對齊，右對齊，居中的：
| 左對齊 | 居 中 | 右對齊 |
| :---- | :----:| -----:|
| 單元格 | 單元格 | 單元格 |
| 單元格 | 單元格 | 單元格 |
| 單元格 | 單元格 | 單元格 |
當冒號在左邊時(或者沒有冒號)整列對齊左邊，當冒號在右邊時整列對齊右邊，當兩端都有冒號時，整列居中。
腳註
這是一個腳註例子[^註釋1]。
[^註釋1]:這是 **腳註內容**。
上面的markdown語法在Typora中是這樣顯示的：
這是一個腳註例子5。
將鼠標懸停在例子右上方的’註釋1’小字時，將會顯示對應的註釋內容。
水平分割線
在空白行中輸入***或者---，然後按下Enter回車鍵，將創建一條水平分割線。
YAML Fornt Matter
Typora也支持YAML Fornt Matter。在文檔的最上方輸入---然後按下Enter回車鍵會出現用於輸入YAML Front Matter的文本塊。你也可以使用Typora上方的工具欄菜單(段落->YAML Front Matter)插入此文本塊。
內容目錄
輸入[toc]然後按下Enter回車鍵，將會讀取當前文檔的標題結構，創建一個內容目錄。當文檔內的標題結構或內容被修改後，內容目錄也會自動更新。
內聯元素
內聯元素在創建後會被解析顯示成特別的樣式。當光標移動到內聯元素上時，將會顯示內聯元素原本的Markdown源碼。下面是每種內聯元素的說明。
鏈接
Markdown支持兩種鏈接表達形式：超鏈接與引用鏈接。
不管哪種形式，鏈接在文檔中顯示的文本要像這樣[鏈接顯示文本]，用方括號括住。
在方括號後面使用圓括號填入鏈接路徑，就創建好了一個超鏈接。你還可以在鏈接路徑後面空一格再接上一段引號引住的註釋，當鼠標懸停在超鏈接上方時將顯示這段註釋。下面是例子：
這是寫註釋的[超鏈接](http://example.com/ "註釋文字")例子。
[這是不寫](http://example.net/)註釋的超鏈接例子。
上面的寫法會被解析顯示成：
這是寫註釋的超鏈接例子。
這是不寫註釋的超鏈接例子。
內部鏈接
內部鏈接是專門用於跳轉到文檔內部的標題的超鏈接，通過點擊內部鏈接，可以將光標快速跳轉到對應的標題處。例子：
按住Command鍵(對應Windows的Ctrl鍵)+點擊這個內部鏈接，光標將會跳轉到這篇文檔的塊元素標題。而如果你直接點擊內部鏈接，則會切換到完整的源碼。
引用鏈接
引用鏈接是在第一個方括號後緊接一個方括號，其中填入標籤名稱，然後再在下方段落對這個標籤名稱進行定義：
這是一個引用鏈接的[例子][標籤]。
然後在文章的任何一個地方，對這個標籤進行定義。
[標籤]:http://example.com/ "可缺省的標題文字"
在Typora中上面的例子會顯示成：
這是一個引用鏈接的例子。
然後再文章的任何一個地方，再對這個標籤進行定義。
如果顯示的文本本身就是標籤，那麼可以不輸入標籤名稱，直接使用空的方括號——例如，文本baidu本身就適合作爲標籤內容，那麼可以這樣寫：
[baidu][]
然後在其他地方定義這個引用鏈接：
[baidu]:http://www.baidu.com/
在Typora中，直接點擊鏈接會切換到編輯狀態，如果你要打開鏈接，需要按住ctrl鍵再點擊。
網址
Typora允許你在文檔間插入網址鏈接，你可以像這樣<網址鏈接>，在尖括號內輸入網址。
輸入<[email protected]>會變成[email protected]。
Typora也能自動轉換標準格式的網址。例如:www.baidu.com。
圖片
插入圖片的語法和插入超鏈接的語法非常相似，只要在超鏈接語法前加上一個!。像這樣：
你可以直接將圖片文件或者瀏覽器中的圖片用鼠標拖拽進來。當你用鼠標點擊圖片時，Markdown源碼會被顯示出來，你可以進行修改。如果通過拖拽插入的圖片文件與文檔位於同一目錄或子目錄，那麼源碼中會使用相對路徑。
如果你的文章需要發佈到網站上，那麼可以通過YAML Front Matters設置typora-root-url屬性，爲本地的圖片指定對應的網絡路徑前綴。例如，在YAML Front Matters中輸入typora-root-url:/User/Abner/Website/typora.io/,那麼本地資源上傳到網站後會將調整爲，避免圖片路徑出錯。6
你可以點擊這裏瞭解更多相關內容。
斜體(強調)
Markdown通過星號*或者下劃線_表示文字斜體。例如:
*用星號表示斜體*
_用下劃線表示斜體_
上面源碼會顯示成：
用星號表示斜體
用下劃線表示斜體
在文字中間的下劃線會被忽略，因爲這種寫法很容易和代碼中的編寫習慣衝突，例如：
wow_great_stuff
do_this_and_do_that_and_another_thing.
如果你的確想顯示星號或下劃線而不是想設置斜體，可以在星號或下劃線前加上反斜槓\進行轉義:
\*這一段文字在Typora中輸入前後會顯示星號\*
Typora推薦使用*符號設置斜體。
加粗
在文本前後使用兩個*號或者_進行加粗，例子：
**前後兩個星號進行加粗**
__前後兩個下劃線進行加粗__
上面源碼會顯示成：
前後兩個星號進行加粗
前後兩個下劃線進行加粗
Typora推薦使用**設置加粗。
行內代碼塊
通過前後添加(`)符號生成行內代碼塊。與完整的代碼塊不同的是，行內代碼塊用於表示正常文本內的局部代碼。例如：
使用`printf()`函數。
在文檔中會顯示成：
使用printf()函數。
刪除線
因爲使用了GFM2標準，所以在Typora中你可以使用標準Markdown沒有的刪除線語法。
語法~~錯誤的文本~~會顯示成：錯誤的文本
下劃線
下劃線的語法與HMTL的下劃線語法一致。
語法<u>下劃線</u>會顯示成：下劃線
Emoji表情😄
可以像這樣快速輸入表情:smile:。
當你輸入表情語法的過程中，會彈出補全建議浮窗，你也可以在裏面選擇。
行內公式塊
要使用這個功能，首先要通過文件->偏好設置->Markdown->Markdown擴展語法中啓用內聯公式選項。在Tex格式的數學公式前後添加$會生成行內公式塊。例如:$\lim_{x \to\infty} \exp(-x) = 0$將顯示對應的數學公式。
實際使用這個語法的時候，先輸入$號，然後按Esc鍵，將會自動切入到公式輸入狀態。
你可以點擊這裏瞭解更多相關內容。
下標
要使用這個功能，首先要通過文件->偏好設置->Markdown->Markdown擴展語法中啓用下標選項。在需要設置爲下標的文本前後添加~使文本變爲下標。例如:H~2~O,X~long\ text~。
上標
要使用這個功能，首先要通過文件->偏好設置->Markdown->Markdown擴展語法中啓用上標選項。在需要設置爲上標的文本前後添加^使文本變爲上標。例如:x^2^。
高亮
要使用這個功能，首先要通過文件->偏好設置->Markdown->Markdown擴展語法中啓用高亮選項。在需要高亮的文本前後添加==使文本高亮。例如：==高亮==。
內嵌HTLM
Typora還支持使用HTML語法設置一些原始Markdown中不支持的內容。例如：<span style="color:red">這是紅色的文字</span>會轉換成一段紅色的文字。
嵌入網頁
你可以在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>
視頻
你可以使用HTML的<video>標籤嵌入視頻。例如:
<video src="xxx.mp4" />
其他HTML支持
你可以點擊這裏瞭解更多相關內容。