Typora使用指南&Markdown编辑器使用语法（v0.9.68）

Lison , v1.0.0, 2019.03.06

Typora使用指南 &Markdown编辑器使用语法（v0.9.68）

一、概述

Markdown诞生自 Daring Fireball之手，点击这里可以找到最早版本的语法标准。然而，它的语法标准因解析器和编辑器而异，Typora使用的是GitHub Flavored Markdown标准。

需要注意的是在Markdown中的HTML代码块可以被识别但并不会被解析和编译。同样要注意的是，保存之后的文档格式可能会对最初的编写的文档格式有所微调。

二、块元件

段落和行间隔

段落，顾名思义就是由一行或多行文本组成的，以段为形式的结构。在Markdown语法中，段落间以一行以上的空行作分隔。在Typora中，你只需要按一下Enter就可以插入一个新的段落。

​ 按Shift+Enter可以创建一个比段落间距更小的行间距。然而，大多数的Markdown解析器会忽略这个方式创建的行间距，但是你可以通过在这一行的最后插入两个空格Space或者插入
令解析器强制识

标题

# 这是一个一级标题

## 这是一个二级标题

###### 这是一个六级标题
在Typora中，在标题文本前输入# ，然后按下Enter可以创建一个标题

引用

Markdown使用邮件风格的>符号来创建引用块。栗如：

> (忽略双引号) 这是一个引用快

引用快

在Typora中，只需要输入>之后输入需要的引用内容就可以生成引用块格式。Typora在随后的输入过程中会自动为你添加>和行间隔。引用块内的引用也是被允许的，只需要在引用块内同样使用>即可。

普通清单

输入 * 清单事项一 就会创建一个无需列表 这里的 * 符号可以用 - 和 + 代替

输入 1. 清单事项一 就会创建一个有序的列表语法实例

• 无需列表
• 无序列表

有序列表二

1. 有序列表
2. 有序列表

代码块

​ Typora仅仅支持GFM的代码块，源码块是不支持的。[^此处翻译不确定]使用代码块的语法非常简单，输入`````然后按下Enter 就可以。

​ 另外还可以自定义代码块的语言，只需要在 `````后追加输入所需要的语法名称后，我们就会通过语法高亮来实现它，栗如：

public static void main(String[] args) {
    System.out.println("浮生若梦，不负初情");
}

数学公式

你可以通过使用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}

​

$${\mathbf{V}}_1\times {\mathbf{V}}_2=\left|\begin{array}{ccc}\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{array}\right|$$

表格

输入|标题一|标题二|然后按下Enter将会创建一个有两个列的表格

标题一	标题二
这个是表格	表格

分割线

在一空行输入***或者--- 然后按下Enter可以创建一条分隔线

---

---

目录

输入［toc］然后按下Enter就会产生一个自动根据标题和标题等级自动创建的目录框。

---

三、事实元件

链接

Markdown支持两种类型的链接：直连链接和间接链接

在上面两种链接类型中，链接文本都用[方框]来定义。

通过在[ ]后追加带有链接地址的( )来创建一个直接链接。在括号中，插入你需转到的网址链接，还可以在链接后追加一个"文本"来自定义所通往链接的网站标题。栗子如下：

[百度一下](www.baidu.com/ "百度一下")
我的博客 [苍云烟](https://blog.csdn.net/qq_34599132/ "苍云烟")

上面语法效果如下：

百度一下

我的博客 苍云烟

1). 内部链接

​ 你可以把( )中的链接换成所在文档的标题，这样通过点击这个链接就能实现文档内部的跳转。
​ 例如：

[代码块](代码块 "代码块")

我的博客 代码块

2). 引用链接

引用类型的链接会使用第二个[ ]用来放置一个对应相应链接地址的标签，例如：

这是个引用链接的[例子][id]呦。

然后，你需要在文档的任何位置对标签作出有效的定义。

[id]:https://www.baidu.com// "百度"

效果如下：

这是个引用链接的百度的[例子][id]呦。

然后，你需要在文档的任何位置对标签作出有效的定义。

另一种简洁的语法可以使用文本本身作为链接的名称，因而允许忽略掉链接的名称也可以实现地址追踪，所以第二个[ ]只需要空着就好了，但是还是需要对文本本身作出定义以提供追踪地址。

[baidu][]
然后输入对文本本身的定义：

[baidu]:http://baidu.com/

在Typora中，Click链接就会展开语法结构供你编辑，Ctrl + Click会在内置浏览器中此超链接。

URLs

图片也类似链接，但是需要额外的符号!放置在这一行的最开头。图片的语法结构如下所示：

![图片名称](/path/to/img.jpg)
![图片名称](/path/to/img.jpg "可选名字")

你也可以使用drag&drop动作从图片文件或者网页浏览器实现插入图片的操作。随后可以通过点击图片来编辑语法的源码达到进一步修饰图片的效果。如果图片文件和所编辑的markdown文档在相同目录或亚目录则drop&drop操作会自动生成对应的相对路径。

斜体

Markdown识别*和_作为斜体语法的标识。用一个*或_修饰的文本会有一个HTML的标签，例如：

*一个乘号斜体*

_一个下划线斜体_

效果如下

一个乘号斜体

一个下划线斜体

GFM会忽视掉文本中的下划线，而下划线在编码和名字中使用普遍，例如：

wow_great_stuff
do_this_and_do_that_and_another_thing.

另一需要注意的问题是如果你需要*或_本身而不想让它编译成此处的强调标识，你可以使用\来免除编译，

例如：

\*这个文本是被乘号修饰的，但是但不会变成斜体\*

效果如下：

*这个文本是被乘号修饰的，但是但不会变成斜体*

附：Typora推荐使用*符号。

强调

两个 * 或者 _ 连用会产生一个HTML标签 实现强调加粗的效果

**两个乘号连用**
__两个下划线连用__

效果如下

两个乘号连用
两个下划线连用

代码

想要创建一个实时显示的代码，用两个` ``符号修饰就可以了。不像预格式化的代码块，这里的实时代码使用正常的段落来表达代码形式

使用 `printf()`功能

效果如下

使用 printf()功能

删除线

GFM增添了使用符号添加删除线的语法，而标准的Markdown无此功能

~~错误的文本~~ 显示为 错误的文本

下划线

下划线功能由来源HTML的标签代码实现。

下划线 下划线

表情

输出表情需要借助 : 符号

例如: ：smile 显示为 ?

使用者可以通过使用ESC键触发表情建议补全功能，也可在功能面板启用后自动触发此功能。同时，直接从菜单栏Edit -> Emoji & Symbols插入UTF8表情符号也是可以的。

HTML

Typora不能使用HTML元素，但是Typora可以解析和编译非常有限的HTML元素，作为Markdown功能的补充，这些有限的功能包括：

• 下划线： 下划线
• 图片： （HTML标签中的width, height 以及属于样式的width, height, zoom样式可以被识别和应用。）
• 
• 注释或评论:
• 超链接: 百度一下百度一下

大多数这些属性、样式或分类会被忽略。对其他的标签，Typora会将它们以HTML片段的形式表达。

下标

想要使用这个功能，需要在设置面板的 Markdown 栏启动它，之后使用~来修饰下标文本。例如：

H~2~O 和X~long\ text~ 显示为 H₂O 和X_{long text} 。

上标

想要使用这个功能，需要在设置面板的 Markdown 栏启动它，之后使用^来修饰下标文本。栗如：

X^2^ 显示为 X²

高亮

想要使用这个功能，需要在设置面板的Markdown 栏启动它，之后使用==来修饰高亮文本，栗如：

==highlight== 显示为 highlight 。

加粗样式