Typora V0.9.83官方Maekdown中文使用文档

概览

Markdown由Daring Fireball创建；原始文档在这。但是在不同的解释器和编辑器之间Markdown的语法是不同的。Typora 使用的是 GitHub Flavored Markdown.

块元素

段落和换行

段落是单行或多行的文本。在Markdown源码中，段落由两个或多个空行分隔。在Typora中，只需要一个空行（按一次 Enter ）就可以创建一个段落。

按 Shift + Enter实现换行。大多数Markdown解释器会忽略单个换行，所以为了适应大多数的解释器，可以在行尾端添加两个空格，或者输入<\br>。

标题

在一行的开始使用1-6个#来输入标题，依次对应1至6级标题。例如：

# 这是一级标题

## 这是二级标题

###### 这是六级标题

在Typora中，在一个或多个'#' 之后输入标题文本，按回车后会创建一个标题。

块引用

Markdown使用>符号创建块引用，表现如下：

> 两个段落的块引用，这是第一段。
>
> 这是第二段。与其说孤僻不如说因为他们追求的是自己所热爱、所践行的信仰，而这种信仰在普通大众看来有些极端，与千千万万民众的不同导致他们走向了孤僻。



> 这是一个段落的块引用，两个块引用之间有三个空行。

在Typora中，在>之后输入引用内容可以生成一个块引用。之后Typora会适当的插入>或换行符。嵌套使用快引用只需再额外输入>即可。

列表

输入* 列表项1将会创建一个无序列表——*可以用+或者-替代。
输入1. 列表项1将会创建一个有序列表。Markdown源代码如下：

## 无序列表
*   红色
*   绿色
*   蓝色

## 有序列表
1.  红色
2. 	绿色
3.	蓝色

任务列表

任务列表是列表项被[]或[x]标记的列表。例如：

- [ ] 一个列表项
- [ ] 一个列表项
- [ ] 一个列表项
- [ ] 一个列表项
- [x] 一个列表项

可以通过点击项目前的复选框改变项目的完成/未完成状态。

代码块(围墙Fenced)

Typora仅支持GitHub Flavored Markdown中的围墙(fenses)。Markdown中的原始块元素并不支持。

使用十分简单：输入 ```然后回车。在 ``` 后面添加语言标识符，内部的代码将会以语法高亮来显示。

这是一个示例：

​```
function test(){
console.log("hello world");
}
​```
语法高亮
​```ruby
require 'redcarpet'
markdown = Redcarpet.new("Hello World!")
puts markdown.to_html
​```

数学块

可以使用MathJax来呈现LaTeX数学表达式。

输入$$后回车来添加数学表达式。这将会触发一个接受Tex/LaTeX源码的输入域。例如：

在markdown源文件中，math块是由一对$$标记包装的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}
$$

可以在这里查看更多详细的内容。

表格

输入 | First Header | Second Header | 然后回车。这将会创建一个两列的表格。

创建好表格后，当表格获得焦点时，会触发一个工具栏，可以用来设置尺寸、对齐方式或者删除这个表格。也可以利用上下文菜单来复制、添加、删除行/列。

表格的完整语法如下所述，但在Tupora中不像markdown源代码那样需要知道所有的代码细节，Typora可以自动生成表格进行可视化操作。

在markdown源代码中：

| Frist Header | Second Header |
| -------------| --------------|
| Content Cell | Content Cell  |
| Content Cell | Content Cell  |

也可以在表格中使用行内Markdown，比如链接、加粗、倾斜或者删除线。

最后一点，通过在首行使用冒号:来确定在当前列中是左对齐、右对齐还是居中对齐：

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

冒号在最左边代表左对齐，在最右边代表右对齐，在两头代表居中对齐。

脚注

你可以使用[^footnote]来创建脚注。
[^footnote]:这里是**脚注**的*文本*。

具体表现如下：

你可以使用¹来创建脚注。

鼠标经过右上角的‘footnote’可以显示脚注的内容。

水平线

在空行内输入***或者---然后回车可以画一条水平线。

---

---

YAML Front Matter（YAML前页）

Typora现在支持 YAML 前页。通过在页面顶部输入---来创建一个元数据快。或者可以从Tpyora的顶部菜单插入一个元数据快。

目录表(TOC)

输入[toc]然会回车，可以创建一个目录表。目录表将会抽取所有标题内容放入目录表中，目录表可以随着您的输入实时刷新。

Span元素

Span元素在输入后会被立即解析和呈现，将光标移动到这些Span元素中间会将这些元素展开为mardown源代码。下面解释每个span元素的语法。

链接

Markdown支持两种类型的链接：内联和引用。

在这两种样式中，链接文本都是使用[方括号]包裹。

要创建内联链接，需要在连接文本右方括号之后使用一组圆括号。在圆括号中，将希望链接指向的位置的链接以及链接的可选标题，用引号包括起来。例如：

这是一个内联链接的 [例子](http://example.com/ "Title") 。

[这个链接](http://example.net/)没有标题属性

这是一个内联链接的 例子 。

这个链接没有标题属性.。

内联链接

可以将链接指向标题，标题可以创建一个书签，允许您在点击后跳转到相应的位置。例如：

Ctrl + 点击这个链接将会跳转到当前页面的块元素。可以通过移动光标或点击这个链接文本查看源代码。

引用链接

引用链接将使用两组方括号，第二组方括号放置链接的标识符。

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

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

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

在Typora中他们是这样呈现的:

这是引用链接的例子 。

引用链接允许第二个方括号中的内容为空，此时第一个方括号内的链接名称将被用作链接的标识符。例如：

[Google][]
And then define the link:

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

在Typora中，单击链接将展开它并可以进行编辑，Ctrl+click将在web浏览器中打开这个超链接。

URLs

Typora 允许你输入 URLs作为链接， 使用 <brackets>包裹。

<[e-mail]> 将变为[e-mail].

Typora还将自动链接标准url。例如: www.google.com.

图像

图像和链接的语法类似，但是它们需要在链接的开头额外添加一个 ! 符号。 插入图像的语法如下：

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

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

你可以使用拖放操作从文件或者网站中插入图。 可以通过单击图像来修改markdown源代码。如果使用拖放添加的图像与当前编辑的文档位于相同的目录或子目录中，则将使用相对路径。

如果你使用markdown来建立网站，你可以用属性“typora-root-url”在YAML Front Matters中为图像预览指定一个URL前缀。例如，在 YAML Front Matters中输入’ typora-root-url:/User/Abner/Website/typora.io/ ’ ，然后在Typora中 ![alt](/blog/img/test.png) 将被视为![alt](file:///User/Abner/Website/typora.io/blog/img/test.png)。

你可以点击 这里查看更多细节。

强调

Markdown 将星号(*) 和下划线 (_) 作为强调的标志。 使用一个 * 或_ 包裹文本类似于HTML中的<em>标签， 例如:

*single asterisks*

_single underscores_

输出:

single asterisks

single underscores

通常在代码和名字中会使用下划线，而GFM将会忽略这些单词中的下划线，例如:

wow_great_stuff

do_this_and_do_that_and_another_thing.

若要在原本用作强调分隔符的位置生成文字星号或下划线，可以使用反斜杠转义：

\*这些文字被星号包围\*

Typora 建议使用 * 符号.

加强/加粗(Strong)

里那个* 或者_ 会产生类似被 HTML <strong> 标签包裹的想过，例如:

**double asterisks**

__double underscores__

输出:

double asterisks

double underscores

Typora 建议使用 ** 符号.

代码

指示内联代码，使用反引号(`)将内联代码包裹起来，和预格式化的代码块不同，内联代码在正常段落中嵌入代码。例如

使用 `printf()` 函数。

表现为：

使用 printf() 函数。

删除线

GFM添加了标准Markdown所不支持的删除线格式。

~~删除文本~~ becomes 删除文本.

下划线

下划线由原生HTML支持。

<u>下划线</u> 会变成下划线.

Emoji表情 

输入Emoji的代码形式 :smile:。

用户可以通过按Esc键来开关自动完成提示，或者直接在偏好设计面板中控制自动完成提示。

内联公式

首先要在 文件 >偏好设置中的Markdown标签中打开此功能。然后使用 $ 包裹TeX指令。例如：$\lim_{x \to \infty} \exp(-x) = 0$ 将会以LaTeX指令呈现。

要触发内联公式的预览首先输入 “$”，然后按 ESC 键， 最后输入一个TeX 指令。

You can find more details here.

你可以点击 这里查看更多细节。

下标

首先要在 文件 >偏好设置中的Markdown标签中打开此功能。然后使用~ 包裹下标文本。例： H~2~O, X~long\ text~/

上标

首先要在 文件 >偏好设置中的Markdown标签中打开此功能。然后使用^ 来包裹上标文本，例如：X^2^.

高亮

首先要在 文件 >偏好设置中的Markdown标签中打开此功能。 然后使用 == 包裹高亮文本。例如==highlight==。

HTML

你可以使用HTML来设置纯Markdown不支持的文本样式。例如, 使用<span style="color:red">这个文本是红的</span> 来添加红色文本。

嵌入内容

有些网站提供基于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>标签来嵌入视频，例如：

<video src="xxx.mp4" />

其他HTML支持

你可以点击这里查看更多细节。

---

1. 这里是脚注的文本。 ↩︎