Typora语法详解（一）

---

title: typora使用指南
date: 2022/1/21 13:05:25

---

一.概述

Typora 正在使用 GitHub Flavored Markdown。

二.块元素

2.1段落和换行符

段落只是一行或多行连续的文本。在markdown源代码中，段落由多个空行分隔。在Typora中，只需按下 Return 即可创建新段落。

例：

第一段

第二段

第三段

可以看到三段一共占了5行。

2.2标题

再typora中，有六种标题，在行的开头使用1-6个＃字符，对应于标题级别1-6。

可以使用Ctrl+1~Ctrl+6设置这一行的标题。

# 1
## 2
### 3
#### 4
##### 5
###### 6

1

2

3

4

5

6

普通文字大小

2.3引用文字

Markdown使用>符号生成引用块，只需输入>符号后跟引用内容即可生成块引用。Typora将插入正确的>符号或换行符。通过添加额外级别的>符号允许在块引用内嵌入另一个块引用。

单层引用：

1层引用

多层引用：

1层引用

2层引用

3层引用

源代码：

2.4列表

输入* 将创建一个无序列表，该* 符号可以替换为 + 或 -，可以使用快捷键Ctrl+Shift+]快速创建一个无序列表或者将同嵌套等级 已经创建好的有序列表转换成无序列表。

输入1. 将创建一个有序列表，可以使用快捷键Ctrl+Shift+[快速创建一个有序列表或者将同嵌套等级已经创建好的无序列表转换成有序列表。

示例：

无序列表

• 红色
• 绿色
• 蓝色

有序列表

1. 红色
2. 绿色
3. 蓝色

示例源代码：

*   红色
*   绿色
*   蓝色

1.  红色
2. 	绿色
3.	蓝色

可以设置多级嵌套列表，不同嵌套等级的列表可以是不同类型的，但是同一级的列表必须是同一类型的。

示例：

1. 第一层
   • 第二层
     1. 第三层

示例源代码（注意不同嵌套等级前方的缩进大小）：

1. 第一层
   - 第二层
     1. 第三层

2.5任务列表

任务列表是标记为[ ]或[x]（未完成或完成）的项目的列表，可以通过单击项目前面的复选框来个更改完成状态。可以使用快捷键Ctrl+Shift+x快速创建一个任务列表。

任务列表中项目前面的复选框根据主题CSS文件设置的不同而不同，详情见自定义CSS。

示例：

• 完成项目
• 未完成项目

示例源代码如下：

- [x] 完成项目
- [ ] 未完成项目

可以设置任务列表的不同等级，这只是视觉效果，实质上二者项目之间没有影响。

• 根项目
  • 子项目

2.6代码块

Typora仅支持 Github Flavored Markdown 中的栅栏式代码块。不支持 markdown 中的原始代码块。可以使用快捷键Ctrl+Shift+K快速创建一个代码块。

手动创建代码块的语句有两种：

• 创建的时候就指定好语言。
• 创建之后再指定语言。

创建的时候就指定好语言：

```java
	psvm
```

创建之后再指定语言：

```
	psvm
```

2.7数学公式块

Typora可以使用 MathJax 渲染 LaTeX 数学表达式。

输入 $$, 然后按键Enter将触发一个接受Tex / LaTex源代码的输入区域。可以使用快捷键Ctrl+Shift+M快速创建一个公式块。

示例如下：
$${\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|$$

示例源代码如下：

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

2.8表格

Typora的表格创建有两种方式：

• 可以使用快捷键Ctrl+T快速创建一个空表格（没有标题和数据）。
• 也可以使用| First Header | Second Header |创建一个包含两列的表（没有数据）。

创建表后，焦点在该表上将弹出一个表格工具栏，您可以在其中调整表格，对齐或删除表格。您还可以使用上下文菜单来复制和添加/删除列/行。

使用快捷键Ctrl+T快速创建一个空表格（默认4行3列）：

1	2	2

源代码如下：

| 1    | 2    | 2    |
| ---- | ---- | ---- |
|      |      |      |
|      |      |      |
|      |      |      |

也可以使用| First Header | Second Header |创建一个包含两列的表

header1	header2

源代码如下：

| header1 | header2 |
| ------- | ------- |
|         |         |

可以在表格中包括内联 Markdown 语法，例如链接，粗体，斜体或删除线。

如果在标题行添加冒号将文本定义为左对齐，右对齐或居中对齐，

• 左侧的冒号表示左对齐的列;
• 最右侧的冒号表示右对齐的列;
• 两侧的冒号表示中心对齐的列。

示例如下：

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

源代码如下：

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

2.9脚注

可以使用[^footnote]创建脚注，可以讲鼠标移到脚注上看到脚注的内容，也可以点击脚注进行跳转。

示例如下：

脚注1¹

脚注2²

示例源代码如下：

脚注1[^1]

脚注2[^2]

[^1]: 第一个脚注。
[^2]: 第二个脚注。

2.10水平线

输入 *** 或 --- 在空行上按Enter键将绘制一条水平线。水平线的样式和主题的CSS文件设置有关。

---

---

2.11YAML Front Matter

Front-matter 是文件最上方以 — 分隔（三个连续短横）的区域，用于指定个别文件的变量，举例来说：

typora-root-url: 指定本文文中所插入引用的图片等页面元素所参考依据的路径

2.12目录 (TOC)

输入 [toc] 然后按 Return 键将创建一个“目录”部分，自动从文档内容中提取所有标题，其内容会自动更新。目录的样式依据主题的CSS文件设置。

2.13图表

Typora 支持mermaid、sequence和flowchart。

• flowChart
• sequence
• mermaid

创建方式和创建代码块方式相同，需要提前指定好所使用的语言，只有这样代码才会被渲染成图表。

2.13.1sequence

2.13.2flow：

2.13.3mermaid

三.Span 元素

在输入后Span元素会被立即解析并呈现。在这些span元素上移动光标会将这些元素扩展为markdown源代码。

3.1链接

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

在这两种样式中，链接文本都写在[方括号]内。要创建内联链接，请在链接文本的结束方括号后立即使用一组常规括号。在常规括号内，输入URL地址，以及可选的用引号括起来的链接标题。

This is an example inline link.

This link has no title attribute.

3.1.1内部链接

您可以将常规括号内的 href 设置为文档内的某一个标题，这将创建一个书签，允许您在单击后跳转到该部分。

示例：

单击 块元素 将跳转到标题 块元素处。

示例源代码：

单击 [此链接](#二.块元素) 将跳转到标题 `块元素`处。

3.1.2URL网址

Typora可以将 URL 作为链接插入，用 <括号括起来>。

例如：

<www.baidu.com>

示例源代码：

<www.baidu.com>

3.2图片

图像与链接类似， 但在链接语法之前需要添加额外的 !字符。

![图片1](/path/to/img.jpg)

![图片2](/path/to/img.jpg "可选标题")

在偏好设置中可以对图像进行设置

3.3强调

Markdown 将星号*和下划线_视为强调的指示（推荐使用*，因为默认就是使用它）。可以使用快捷键Ctrl+I快速将所选的内容进行斜体处理。要在用作强调分隔符的位置生成文字星号或下划线，可以用反斜杠转义

示例：

正常字体

斜体

*转义正常字体*

示例源代码：

正常字体
*斜体*
\*转义正常字体\*

3.4粗体

用两个星号 *或者下划线_包裹的文本将使用HTML <strong> 标签包裹（默认使用双星号）。可以使用快捷键Ctrl+B快速将所选的内容进行加粗处理。

示例：

正常字体

粗体

示例源代码：

正常字体
**粗体**

3.5代码

要指示代码范围，请使用反引号`进行包裹。与预格式化的代码块不同，代码跨度表示正常段落中的代码。可以使用Ctrl+Shift+`快速创建代码行。

示例：

print("代码")

示例源代码：

`print("代码")`

3.6删除线

GFM通过添加语法来创建删除线文本，标准的Markdown中缺少该文本。可以使用快捷键Alt+Shift+5快速将所选的内容进行加下划线处理。

示例：

正常字体

删除线

示例源代码：

正常字体
~~删除线~~

3.7下划线

下划线由原始HTML提供支持，使用<u>下划线</u> 变成 下划线。可以使用快捷键Ctrl+U快速将所选的内容进行加下划线处理。

示例：

正常字体

下划线

示例源代码：

正常字体
<u>下划线</u>

3.8表情符号

输入表情符号的语法是 :smile:

可以通过 ESC 按键触发表情符号的自动完成建议，或者在偏好设置面板里启用后自动触发表情符号。此外，还支持直接从 Edit -> Emoji & Symbols 菜单栏输入UTF8表情符号字符。

使用:进行表情提示。

示例：
😸

♐️

示例源代码：

:smile_cat:
:sagittarius:

3.9内联数学公式

要使用此功能，首先，请在 偏好设置 面板 -> Markdown扩展语法 选项卡中启用它。然后使用 $ 来包裹TeX命令。

示例：

$a=b\times c$

示例源代码：

$a = b\times c$

3.10下标

要使用此功能，首先，请在 偏好设置 面板 -> Markdown扩展语法 选项卡中启用它，然后用 ~ 来包裹下标内容。

示例：

a₁₁，a₁₂

示例源代码：

a~11~，a~12~

3.11上标

要使用此功能，首先，请在 偏好设置 面板 -> Markdown扩展语法 选项卡中启用它。然后用 ^ 来包裹上标内容。

示例：

a¹¹，a¹²

示例源代码：

a^11^，a^12^

3.12高亮

要使用此功能，首先，请在 偏好设置 面板 -> Markdown扩展语法 选项卡中启用它。然后用 == 来包裹高亮内容，例如： ==highlight==。

示例：

highlight

示例源代码：

==highlight==

3.13注释

采用了和HTML文件同样的注释格式。

示例：

示例源代码：

<!-- 这里是注释 -->

四.HTML

您可以使用HTML来设置纯 Markdown 不支持的内容，例如， <span style="color:red">this text is red</span> 用于添加红色文本。

示例：

this text is red

4.1视频

您可以使用 <video> HTML标记嵌入视频。

4.2网页片段

See the Pen Snake Game by moPsych (@moPsych) on CodePen.

4.3已知支持的标签

按钮

快捷键

字体颜色

漢 ㄏㄢˋ 漢 ㄏㄢˋ

I have keys but no locks. I have space but no room. You can enter but can't leave. What am I? A keyboard.

---

1. 第一个脚注。 ↩︎

2. 第二个脚注。 ↩︎