Markdown For Typora 【抄自原網(wǎng)站】

概述

Markdown 由 Daring Fireball創(chuàng)建洞就，原始指南在 這里。但是轴脐，它的語(yǔ)法因不同的解析器或編輯器而異。Typora 正在使用 GitHub Flavored Markdown。

大綱

[TOC]

塊元素

段落和換行符

段落只是一行或多行連續(xù)的文本匀哄。在markdown源代碼中，段落由多個(gè)空行分隔雏蛮。在Typora中涎嚼，您只需按下 Return 即可創(chuàng)建新段落。

按 Shift + Return 可創(chuàng)建單個(gè)換行符底扳。但是铸抑，大多數(shù)markdown解析器將忽略單行中斷，要使其他markdown解析器識(shí)別您的換行符衷模，可以在行尾留下兩個(gè)空格鹊汛，或者插入 <br/>.

標(biāo)題

標(biāo)題在行的開(kāi)頭使用1-6個(gè)＃字符，對(duì)應(yīng)于標(biāo)題級(jí)別1-6阱冶。例如：

# 這是一級(jí)標(biāo)題

## 這是二級(jí)標(biāo)題

###### 這是六級(jí)標(biāo)題

在typora中刁憋，輸入'＃'后跟標(biāo)題內(nèi)容，按下 Return 鍵將創(chuàng)建標(biāo)題木蹬。

引用文字

Markdown使用電子郵件樣式>字符進(jìn)行塊引用至耻。它們表示為：

> 這是一個(gè)有兩段的塊引用。這是第一段镊叁。
>
> 這是第二段尘颓。Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, risus.



> 這是另一個(gè)只有一個(gè)段落的塊引用。有三個(gè)空行分隔兩個(gè)塊引用晦譬。

在typora中疤苹，只需輸入'>'后跟引用內(nèi)容即可生成塊引用。Typora將為您插入正確的“>”或換行符敛腌。通過(guò)添加額外級(jí)別的“>”允許在塊引用內(nèi)嵌入另一個(gè)塊引用卧土。

列表

輸入 * list item 1 將創(chuàng)建一個(gè)無(wú)序列表惫皱，該 * 符號(hào)可以替換為 + 或 -.

輸入 1. list item 1 將創(chuàng)建一個(gè)有序列表，其markdown源代碼如下：

## 無(wú)序列表
*   紅色
*   綠色
*   藍(lán)色

## 有序列表
1.  紅色
2.  綠色
3.  藍(lán)色

任務(wù)列表

任務(wù)列表是標(biāo)記為[ ]或[x]（未完成或完成）的項(xiàng)目的列表尤莺。例如：

- [ ] 這是一個(gè)任務(wù)列表項(xiàng)
- [ ] 需要在前面使用列表的語(yǔ)法
- [ ] normal **formatting**, @mentions, #1234 refs
- [ ] 未完成
- [x] 完成

您可以通過(guò)單擊項(xiàng)目前面的復(fù)選框來(lái)更改完成/未完成狀態(tài)旅敷。

（柵欄式）代碼塊

Typora僅支持Github Flavored Markdown中的柵欄式代碼塊。不支持markdown中的原始代碼塊颤霎。

使用柵欄式代碼塊很簡(jiǎn)單：輸入```之后輸入一個(gè)可選的語(yǔ)言標(biāo)識(shí)符媳谁，然后按return鍵后輸入代碼，我們將通過(guò)語(yǔ)法高亮顯示它：

這是一個(gè)例子：

```
function test() {
  console.log("notice the blank line before this function?");
}
```

語(yǔ)法高亮：
```ruby
require 'redcarpet'
markdown = Redcarpet.new("Hello World!")
puts markdown.to_html
```

數(shù)學(xué)公式塊

您可以使用 MathJax 渲染 LaTeX 數(shù)學(xué)表達(dá)式捷绑。

輸入 $$, 然后按“return”鍵將觸發(fā)一個(gè)接受Tex / LaTex源代碼的輸入?yún)^(qū)域韩脑。以下是一個(gè)例子：

在markdown源文件中，數(shù)學(xué)公式塊是由'$$'標(biāo)記包裝的 LaTeX 表達(dá)式：

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

表格

輸入 | First Header | Second Header | 并按下 return 鍵將創(chuàng)建一個(gè)包含兩列的表粹污。

創(chuàng)建表后段多，焦點(diǎn)在該表上將彈出一個(gè)表格工具欄，您可以在其中調(diào)整表格壮吩，對(duì)齊或刪除表格进苍。您還可以使用上下文菜單來(lái)復(fù)制和添加/刪除列/行。

可以跳過(guò)以下描述鸭叙，因?yàn)楸砀竦膍arkdown源代碼是由typora自動(dòng)生成的觉啊。

在markdown源代碼中，它們看起來(lái)像這樣：

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

您還可以在表格中包括內(nèi)聯(lián)Markdown語(yǔ)法沈贝，例如鏈接杠人，粗體，斜體或刪除線宋下。

最后嗡善，通過(guò)在標(biāo)題行中包含冒號(hào)：您可以將文本定義為左對(duì)齊，右對(duì)齊或居中對(duì)齊：

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

最左側(cè)的冒號(hào)表示左對(duì)齊的列; 最右側(cè)的冒號(hào)表示右對(duì)齊的列; 兩側(cè)的冒號(hào)表示中心對(duì)齊的列学歧。

腳注

您可以像這樣創(chuàng)建腳注[^footnote].

[^footnote]: Here is the *text* of the **footnote**.

將產(chǎn)生：

您可以像這樣創(chuàng)建腳注^[1].

鼠標(biāo)移動(dòng)到‘footnote’上標(biāo)中查看腳注的內(nèi)容罩引。

水平線

輸入 *** 或 --- 在空行上按 return 鍵將繪制一條水平線。

YAML Front Matter

Typora 現(xiàn)在支持 YAML Front Matter 枝笨。 在文章頂部輸入 --- 然后按 Enter 鍵將引入一個(gè)袁铐，或者從菜單中插入一個(gè)元數(shù)據(jù)塊。

目錄 (TOC)

輸入 [toc] 然后按 Return 鍵將創(chuàng)建一個(gè)“目錄”部分横浑，自動(dòng)從文檔內(nèi)容中提取所有標(biāo)題剔桨，其內(nèi)容會(huì)自動(dòng)更新。

圖表 (Sequence, Flowchart and Mermaid)

Typora 支持, sequence, flowchart and mermaid, 使用前要先從偏好設(shè)置面板啟用該功能徙融。

詳細(xì)信息請(qǐng)參閱此 文檔

Span 元素

在您輸入后Span元素會(huì)被立即解析并呈現(xiàn)领炫。在這些span元素上移動(dòng)光標(biāo)會(huì)將這些元素?cái)U(kuò)展為markdown源代碼。以下將解釋這些span元素的語(yǔ)法张咳。

鏈接

Markdown支持兩種類型的鏈接：內(nèi)聯(lián)和引用帝洪。

在這兩種樣式中，鏈接文本都寫(xiě)在[方括號(hào)]內(nèi)脚猾。

要?jiǎng)?chuàng)建內(nèi)聯(lián)鏈接葱峡，請(qǐng)?jiān)阪溄游谋镜慕Y(jié)束方括號(hào)后立即使用一組常規(guī)括號(hào)。在常規(guī)括號(hào)內(nèi)龙助，輸入U(xiǎn)RL地址砰奕，以及可選的用引號(hào)括起來(lái)的鏈接標(biāo)題。例如：

This is [an example](http://example.com/ "Title") inline link.

[This link](http://example.net/) has no title attribute.

將產(chǎn)生：

This is an example inline link. (<p>This is <a title="Title">)

This link has no title attribute. (<p><a >This link</a> has no)

內(nèi)部鏈接

您可以將常規(guī)括號(hào)內(nèi)的 href 設(shè)置為文檔內(nèi)的某一個(gè)標(biāo)題提鸟，這將創(chuàng)建一個(gè)書(shū)簽军援，允許您在單擊后跳轉(zhuǎn)到該部分。例如：

Command(在Windows上：Ctrl) + 單擊 此鏈接 將跳轉(zhuǎn)到標(biāo)題 塊元素處称勋。 要查看如何編寫(xiě)胸哥，請(qǐng)移動(dòng)光標(biāo)或按住 ? 鍵單擊以將元素展開(kāi)為Markdown源代碼。

參考鏈接

參考樣式鏈接使用第二組方括號(hào)赡鲜，在其中放置您選擇的標(biāo)簽以標(biāo)識(shí)鏈接：

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

然后空厌，在文檔中的任何位置，您可以單獨(dú)定義鏈接標(biāo)簽银酬，如下所示：

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

在typora中嘲更，它們將呈現(xiàn)為：

This is an example reference-style link.

隱式鏈接名稱快捷方式允許您省略鏈接的名稱，在這種情況下揩瞪，鏈接文本本身將用作名稱赋朦。只需使用一組空的方括號(hào)，例如李破，將“Google”一詞鏈接到google.com網(wǎng)站宠哄，您只需寫(xiě)下：

[Google][]
然后定義鏈接：

[Google]: http://google.com/

在typora中單擊鏈接將其展開(kāi)以進(jìn)行編輯，command+單擊將在Web瀏覽器中打開(kāi)超鏈接喷屋。

URL網(wǎng)址

Typora允許您將URL作為鏈接插入琳拨，用 <括號(hào)括起來(lái)>。

<i@typora.io> 成為 i@typora.io.

Typora也將自動(dòng)鏈接標(biāo)準(zhǔn)URL屯曹。例如： www.google.com.

圖片

圖像與鏈接類似狱庇， 但在鏈接語(yǔ)法之前需要添加額外的 ! 字符。 圖像語(yǔ)法如下所示：

![替代文字](/path/to/img.jpg)

![替代文字](/path/to/img.jpg "可選標(biāo)題")

您可以使用拖放操作從圖像文件或?yàn)g覽器來(lái)插入圖像恶耽。并通過(guò)單擊圖像修改markdown源代碼密任。如果圖像在拖放時(shí)與當(dāng)前編輯文檔位于同一目錄或子目錄中，則將使用相對(duì)路徑偷俭。

有關(guān)圖像的更多提示浪讳，請(qǐng)閱讀 http://support.typora.io//Images/

強(qiáng)調(diào)（斜體）

Markdown將星號(hào) (*) 和下劃線(_) 視為強(qiáng)調(diào)的指示。用一個(gè) * or _ 包裹文本將使用HTML <em> 標(biāo)簽包裹文本涌萤。例如：

*單個(gè)星號(hào)*

_單個(gè)下劃線_

輸出：

單個(gè)星號(hào)

單個(gè)下劃線

GFM將忽略單詞中的下劃線淹遵，這通常用在代碼和名稱中口猜，如下所示：

wow_great_stuff

do_this_and_do_that_and_another_thing.

要在用作強(qiáng)調(diào)分隔符的位置生成文字星號(hào)或下劃線，可以用反斜杠轉(zhuǎn)義：

\*這個(gè)文字被文字星號(hào)包圍\*

Typora建議使用 * 號(hào).

粗體

用兩個(gè) * 或 _ 包裹的文本將使用HTML <strong> 標(biāo)簽包裹透揣，例如：

**雙星號(hào)**

__雙重下劃線__

輸出：

雙星號(hào)

雙重下劃線

Typora建議使用 ** 號(hào)济炎。

代碼

要指示代碼范圍，請(qǐng)使用反引號(hào)（`）進(jìn)行包裹辐真。與預(yù)格式化的代碼塊不同须尚，代碼跨度表示正常段落中的代碼。例如：

使用`printf()`函數(shù)侍咱。

將產(chǎn)生：

使用 printf() 函數(shù)耐床。

刪除線

GFM通過(guò)添加語(yǔ)法來(lái)創(chuàng)建刪除線文本，標(biāo)準(zhǔn)的Markdown中缺少該文本楔脯。

~~錯(cuò)誤的文字撩轰。~~ 變成 錯(cuò)誤的文字。

下劃線

下劃線由原始HTML提供支持淤年。

<u>下劃線</u> 變成 <u>下劃線</u>

表情符號(hào) :smile:

輸入表情符號(hào)的語(yǔ)法是 :smile:

用戶可以通過(guò) ESC 按鍵觸發(fā)表情符號(hào)的自動(dòng)完成建議钧敞，或者在偏好設(shè)置面板里啟用后自動(dòng)觸發(fā)表情符號(hào)。此外麸粮，還支持直接從 Edit -> Emoji & Symbols 菜單欄輸入U(xiǎn)TF8表情符號(hào)字符溉苛。

內(nèi)聯(lián)數(shù)學(xué)公式

要使用此功能，首先弄诲，請(qǐng)?jiān)?偏好設(shè)置 面板 -> Markdown擴(kuò)展語(yǔ)法 選項(xiàng)卡中啟用它愚战。然后使用 $ 來(lái)包裹TeX命令，例如： $\lim_{x \to \infty} \exp(-x) = 0$ 將呈現(xiàn)為L(zhǎng)aTeX命令齐遵。

要觸發(fā)內(nèi)聯(lián)公式的預(yù)覽提示功能：輸入“$”, 然后按 ESC 鍵, 然后輸入TeX命令, 預(yù)覽工具提示將如下所示：

<img src="http://typora.io/img/inline-math.gif" style="zoom:50%;" />

下標(biāo)

要使用此功能寂玲，首先，請(qǐng)?jiān)?偏好設(shè)置 面板 -> Markdown擴(kuò)展語(yǔ)法 選項(xiàng)卡中啟用它梗摇。然后用 ~ 來(lái)包裹下標(biāo)內(nèi)容拓哟，例如： H~2~O, X~long\ text~/

上標(biāo)

要使用此功能，首先伶授，請(qǐng)?jiān)?偏好設(shè)置 面板 -> Markdown擴(kuò)展語(yǔ)法 選項(xiàng)卡中啟用它断序。然后用 ^ 來(lái)包裹上標(biāo)內(nèi)容，例如： X^2^糜烹。

高亮

要使用此功能违诗，首先，請(qǐng)?jiān)?偏好設(shè)置 面板 -> Markdown擴(kuò)展語(yǔ)法 選項(xiàng)卡中啟用它疮蹦。然后用 == 來(lái)包裹高亮內(nèi)容诸迟，例如： ==highlight==。

HTML

您可以使用HTML來(lái)設(shè)置純Markdown不支持的內(nèi)容，例如阵苇， <span style="color:red">this text is red</span> 用于添加紅色文本壁公。

嵌入內(nèi)容

有些網(wǎng)站提供基于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> HTML標(biāo)記嵌入視頻贮尖，例如：

<video src="xxx.mp4" />

其他HTML支持

你可以在 這里找到細(xì)節(jié)。

引自：https://github.com/typora/wiki-website

1. Here is the text of the footnote. ?