Typora Markdown 參考

概覽Overview

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

[TOC]

塊元素

段落和換行符

段落只是一行或多行連續(xù)的文本苛谷。在markdown源代碼中，段落由兩個(gè)或多個(gè)空行分隔格郁。在Typora中腹殿，您只需要一個(gè)空行（按Return一次）即可創(chuàng)建一個(gè)新段落独悴。

按Shift+ Return可創(chuàng)建單個(gè)換行符。大多數(shù)其他markdown解析器將忽略單換行符锣尉，因此為了使其他markdown解析器識(shí)別換行符刻炒，您可以在行的末尾留下兩個(gè)空格，或者插入 自沧。

標(biāo)題

標(biāo)題use 1-6 hash (#) characters at the start of the line, corresponding to header levels 1-6. For example:

在行的開關(guān)使用1-6個(gè)#字符坟奥，對(duì)應(yīng)標(biāo)題級(jí)別1-6。例如：

# This is an H1

## This is an H2

###### This is an H6

在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)容將生成一個(gè)引用塊阻塑。Typora將為您插入正確的“>”或換行符。通過添加額外級(jí)別的“>”嵌套塊引號(hào)（另一個(gè)塊引用內(nèi)的塊引用）果复。

清單

輸入* list item 1將創(chuàng)建一個(gè)無序列表 - *符號(hào)可以替換為+或-叮姑。

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

## un-ordered list
*   Red
*   Green
*   Blue

## ordered list
1.  Red
2.  Green
3.  Blue

任務(wù)列表

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

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

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

（圍欄）代碼塊

Typora僅支持GitHub Flavored Markdown中的圍欄。不支持markdown中的原始代碼塊圍欄耘沼。

使用圍欄很簡單：輸入``` 之后按回車鍵极颓，在```之后添加一個(gè)可選的語言標(biāo)識(shí)符，我們將通過語法高亮顯示它：

Here's an example:

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

syntax highlighting:
?```ruby
require 'redcarpet'
markdown = Redcarpet.new("Hello World!")
puts markdown.to_html
?```

數(shù)學(xué)塊

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

要添加數(shù)學(xué)表達(dá)式菠隆，請輸入$$并按“回車”鍵。這將觸發(fā)一個(gè)接受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}$

在markdown源文件中骇径，math塊是由一對(duì)'$$'標(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}
$$

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

表格

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

創(chuàng)建表后，將焦點(diǎn)放在該表上將打開表格的工具欄钱烟，您可以在其中調(diào)整表格晰筛，對(duì)齊或刪除表格嫡丙。您還可以使用上下文菜單來復(fù)制和添加/刪除單個(gè)列/行。

表的完整語法如下所述读第，但沒有必要詳細(xì)了解完整語法曙博，因?yàn)楸淼膍arkdown源代碼是由Typora自動(dòng)生成的。

在markdown源代碼中怜瞒，它們看起來像：

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

您還可以在表格中包含內(nèi)聯(lián)Markdown父泳，例如鏈接，粗體吴汪，斜體或刪除線惠窄。

最后，通過在標(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)建腳注[^腳注]

[^腳注]: 這兒 是**腳注**的文本

將產(chǎn)生：

你可以這樣創(chuàng)建腳注^[1]近刘。

將鼠標(biāo)懸停在“腳注”上標(biāo)上可查看腳注的內(nèi)容擒贸。

水平分割線

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

YAML Front Matter

Typora現(xiàn)在支持YAML Front Matter觉渴。在文章頂部輸入---介劫，然后按Return以引入元數(shù)據(jù)塊“噶埽或者座韵，您可以從Typora的頂部菜單中插入元數(shù)據(jù)塊。

目錄（TOC）

輸入[toc]并Return按鍵踢京，創(chuàng)建一個(gè)“目錄”節(jié)誉碴。TOC從文檔中提取所有標(biāo)題，并在增加/修改文檔內(nèi)容時(shí)自動(dòng)更新其目錄內(nèi)容瓣距。

Span 元素

Span類型將在鍵入后立即解析和呈現(xiàn)黔帕。將光標(biāo)移動(dòng)到這些span元素的中間會(huì)將這些元素?cái)U(kuò)展為markdown源。下面是每個(gè)span元素的語法說明蹈丸。

鏈接

Markdown支持兩種鏈接樣式：內(nèi)聯(lián)和引用成黄。

在這兩種樣式中，鏈接文本由[方括號(hào)]分隔逻杖。

要?jiǎng)?chuàng)建內(nèi)聯(lián)鏈接奋岁，請?jiān)阪溄游谋镜慕Y(jié)束方括號(hào)[ ]后立即使用一組常規(guī)括號(hào)()。在括號(hào)內(nèi)荸百，將URL指向要指向的鏈接闻伶，以及鏈接的可選標(biāo)題，標(biāo)題用引號(hào)括起來管搪。樣式[ ]( )虾攻，例如：

這是帶標(biāo)題的 [an example](http://example.com/ "Title") 內(nèi)聯(lián)鏈接.

[This link](http://example.net/) 無title屬性.

將產(chǎn)生:

這是示例行內(nèi)鏈接. (This is <a title="Title">)

此鏈接沒有title屬性. (<a >This link</a> has no)

內(nèi)部鏈接

您可以將href設(shè)置為標(biāo)題铡买，這將創(chuàng)建一個(gè)書簽，允許您在單擊后跳轉(zhuǎn)到該部分霎箍。例如：

命令（在Windows上：Ctrl）+單擊此鏈接將跳轉(zhuǎn)到標(biāo)題塊元素奇钞。要查看如何編寫，請移動(dòng)光標(biāo)或單擊該按鈕以?按下該鍵以將元素展開為markdown源漂坏。

參考鏈接

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

這是[示例][id] 參考樣式鏈接.

然后，在文檔中的任何位置顶别，您可以單獨(dú)在一行上定義鏈接標(biāo)簽谷徙，如下所示：

[id]: http://example.com/  "這里是可選標(biāo)題屬性"

在Typora中，它們將被渲染為：

這是示例參考樣式鏈接.

隱式鏈接名稱快捷方式允許您省略鏈接的名稱驯绎，在這種情況下完慧，鏈接文本本身將用作名稱。只需使用一組空的方括號(hào) - 例如剩失，將“Google”字詞鏈接到google.com網(wǎng)站屈尼，您只需編寫：

[Google][]
然后定義鏈接

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

在Typora中，單擊該鏈接將展開它以進(jìn)行編輯拴孤，并且Ctrl+Click在Web瀏覽器中打開超鏈接脾歧。

網(wǎng)址URLs

Typora允許您將URL作為鏈接插入，用<括號(hào)括起來>演熟。

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

Typora還會(huì)自動(dòng)鏈接標(biāo)準(zhǔn)網(wǎng)址鞭执。例如: www.google.com.

圖片Images

圖像具有與鏈接類似的語法，但它們在鏈接開始之前需要額外的字符!芒粹。插入圖像的語法如下所示：

![Alt text](/path/to/img.jpg)

![Alt text](/path/to/img.jpg "Optional title")

您可以使用拖放操作從圖像文件或Web瀏覽器插入圖像兄纺。您可以通過單擊圖像來修改markdown源代碼。如果使用拖放操作添加的圖像與您當(dāng)前正在編輯的文檔位于同一目錄或子目錄中化漆，則將使用相對(duì)路徑囤热。

如果您使用markdown構(gòu)建網(wǎng)站，則可以用YAML Front Matters中的 typora-root-url屬性获三，在本地計(jì)算機(jī)上為要預(yù)覽的圖像指定URL前綴。例如锨苏，在YAML Front Matters中輸入typora-root-url:/User/Abner/Website/typora.io/疙教，那么[圖片上傳失敗...(image-dae27-1554293656078)]將作為[圖片上傳失敗...(image-a26c4a-1554293656078)]在Typora中處理。

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

強(qiáng)調(diào)Emphasis

Markdown treats asterisks (*) and underscores (_) as indicators of emphasis. Text wrapped with one * or _ will be wrapped with an HTML  tag. E.g:

Markdown將星號(hào)（*）和下劃線（_）視為強(qiáng)調(diào)的指示器贞谓。包裝在*或_中的文本將用HTML 標(biāo)簽包裝。例如：

*單星號(hào)*

_單下劃線_

輸出:

單星號(hào)

單下劃線

GFM將忽略單詞中的下劃線葵诈，這通常用于代碼和名稱裸弦，如下所示：

wow_great_stuff

do_this_and_do_that_and_another_thing.

要在其他地方成對(duì)使用*或_祟同，可以反斜杠轉(zhuǎn)義：

\*this text is surrounded by literal asterisks\*

Typora建議使用*符號(hào)表示強(qiáng)調(diào)。

加粗Strong

A double * or _ will cause its enclosed contents to be wrapped with an HTML  tag, e.g:

兩個(gè) *或_將導(dǎo)致其包含的內(nèi)容用HTML 標(biāo)記包裝理疙，例如：

**double asterisks**

__double underscores__

輸出t:

雙星號(hào)

雙下劃線

Typora建議使用**符號(hào)晕城。

代碼Code

要指示代碼的內(nèi)聯(lián)，請使用反引號(hào)（`）進(jìn)行包裝窖贤。與預(yù)格式化的代碼塊不同尺栖，內(nèi)聯(lián)代碼表示正常段落中的代碼迂猴。例如：

Use the `printf()` function.

將產(chǎn)生:

使用printf() 函數(shù).

刪除線Strikethrough

GFM添加語法來創(chuàng)建刪除線文本，標(biāo)準(zhǔn)Markdown中缺少該文本。

~~Mistaken text.~~ 變成~~Mistaken text.~~

下劃線Underlines

下劃線由原始HTML提供支持踱侣。

Underline 變成 Underline.

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

使用語法輸入表情符號(hào):smile:。

用戶可以通過ESC按鍵觸發(fā)表情符號(hào)的自動(dòng)完成建議气忠，或者在首選項(xiàng)面板上啟用后自動(dòng)觸發(fā)表情符號(hào)诫钓。此外，在菜單欄（macOS）中轉(zhuǎn)到Edit- > 也可以支持直接輸入U(xiǎn)TF-8表情符號(hào)字符Emoji & Symbols蹄皱。

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

要使用此功能览闰，請先在偏好設(shè)計(jì)面板 - > Markdown選項(xiàng)卡中啟用它。然后夯接，用$包裝TeX命令焕济。例如： $\lim_{to \infty} \exp(-x)=0$ 將被作為LaTeX命令渲染為公式： $lim_{to \infty} \exp(-x)=0$

要觸發(fā)內(nèi)聯(lián)數(shù)學(xué)公式的內(nèi)聯(lián)預(yù)覽：輸入“$”，然后ESC按鍵盔几，然后輸入TeX命令晴弃。

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

下標(biāo)Subscript

要使用此功能逊拍，請先在偏好設(shè)置面板 - > Markdown選項(xiàng)卡中啟用它上鞠。然后，用于~包裝下標(biāo)內(nèi)容芯丧。例如：H~2~O芍阎，X~long\ text~/ H₂O x_{long text}

上標(biāo)Superscript

要使用此功能，請先在偏好設(shè)置面板 - > Markdown選項(xiàng)卡中啟用它缨恒。然后谴咸，^用來包裝上標(biāo)內(nèi)容。例如：X^2^骗露。x²

突出Highlight

要使用此功能岭佳，請先在偏好設(shè)置面板 - > Markdown選項(xiàng)卡中啟用它。然后萧锉，用于==包裝高亮內(nèi)容珊随。例如：==highlight==。==highlight==

HTML

您可以使用HTML來設(shè)置純Markdown不支持的內(nèi)容。例如叶洞，用于this text is red添加紅色文本鲫凶。this is red

嵌入內(nèi)容Embed Contents

有些網(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

您可以使用<video>HTML標(biāo)記嵌入視頻螟炫。例如：

<video src="xxx.mp4" />

其他HTML支持

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

<div>
<i class="sprite sprite-github"></i>
<i class="sprite sprite-gmail"></i>
<i class="sprite sprite-linkedin"></i>
<i class="sprite sprite-stackoverflow"></i>
<i class="sprite sprite-tumblr"></i>
<i class="sprite sprite-twitter"></i>
</div>
<style>

.sprite {
    background-image: url(spritesheet.png);
    background-repeat: no-repeat;
    display: inline-block;
}

.sprite-github {
    width: 30px;
    height: 30px;
    background-position: -5px -5px;
}

.sprite-gmail {
    width: 30px;
    height: 30px;
    background-position: -45px -5px;
}

.sprite-linkedin {
    width: 30px;
    height: 30px;
    background-position: -5px -45px;
}

.sprite-stackoverflow {
    width: 30px;
    height: 30px;
    background-position: -45px -45px;
}

.sprite-tumblr {
    width: 30px;
    height: 30px;
    background-position: -85px -5px;
}

.sprite-twitter {
    width: 30px;
    height: 30px;
    background-position: -85px -45px;
}

</style>

這兒是腳注文本惭婿，生成網(wǎng)頁時(shí)將在頁末生成此文字不恭。 ?