【Markdown】Typora中文手册

我着重参考官方手册写的，也参考了网上的一些资料 ：

• 添加了几种图表的绘制方法
• 详细介绍了 LaTex 数学公式的方法
• 好像没了，记不得了，写完挺久了

前言

大学毕业的暑期，我决定学好Markdown语言。Markdown是一款轻量级标记语言，通过简单的标记语法，它可以使普通文本内容具有一定的格式。以后的时间里写文章、做笔记、写博客等等文本工作一定不会少，相信这一定会使我以后的文本编写更加便捷。

2019.7.19

Markdown标记语言

• 书写快速，格式整齐美观
• 兼容HTML等多种文本格式，跨平台，广泛运用于网络文档的编写
• 可转化为$L^A{T}_{E}X$、PDF、word等其他文本格式Markdown编译器

Markdown编译器

Markdown编译器有许多，其追求是功能强大、简洁美观。本文使用Typora编译器进行写作，边学习，边记录，边写作：

• 完全免费，支持中文
• 十分简洁、界面美观
• 跨平台，支持linux、windows、mac
• 所见即所得
• 支持公式输入、图片插入
• 所见即所得

Markdown使用什么文本编译器都行，比如记事本、notepad++等。

专有的Markdown文本编译器具有语法高亮、自动补全、实时显示等功能，支持转化为多种格式输出。

网页版在线编译器，可直接在浏览器上编辑，上传笔记，随时下载，写作更为灵活。许多网站支持Markdown语言编辑文章，直接在其自身的网页编译器中使用Markdown语言进行文章编写，列如Github等。

目录

Markdown语法

区域元素（区块元素、块级元素）

段落和断行

在Markdown中，一个段落用 2个以上的空行 来划分。而在Typora中，只需要一个空行（按下一次 Return）就可以开始新的一段。

按下 Shift+Return 可以创建一个单行打断 。大多数编译器（语法解析器）可能会忽略单行打断，为了避免这种情况，可以添加2个空格在单行末尾再进行单行打断；或者，插入<br/>。

注：单行打断是另起一行，而不是另起一段。

标题

在行的开头使用1-6个#号作为标题的标记，对应着1-6级标题。例如：

# 这是一级标题

## 这是二级标题

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

在Typora中，#后面加上1个空格和标题内容后，输入回车，就可以看到效果。

引用

Markdown使用Email风格的 > 符号作为引用标记。使用如下：

> # 引用的标题
> 引用的一段文字
>
> 引用的另一段文字
> > 引用中的引用，就是说，引用嵌套

列表

输入 * + - 符号，将会创建一个 无序列表 条目；输入1. 将会创建一个有序列表条目。例如：

### 无序列表
* 语文
+ 数学
- 英语

### 有序列表
1. 姓名
2. 班级
3. 成绩

任务列表（活动列表、可选列表）

任务列表是可选列表，使用 - [ ] + 内容 创建一个可选任务列表。例如：

- [ ] 一个未完成的任务列表条目
- [x] 一个完成的任务列表条目
- [ ] 任务列表条目可以使用鼠标勾选或取消

使用鼠标可以勾选条目前面的选择框，改变 完成/未完成 状态。

代码区块（代码区域）（围栏）

• 行内代码 可以在文本中间的插入的代码，使用 `code` 来插入到行中；行内代码属于跨度元素。
• 行间代码 显示在行与行之间的代码（多行代码）。在行的开头使用 ```+语言 来开始，末行使用```来结束，中间插入代码；行间代码属于区块元素。
• 也可以使用缩进（4个空格或一个制表符）来插入到行之间。

注：` 是反单引号、~输入

这里`while(1)`表示无限循环。
​```c
while(1)
{
	printf("这是一段C语言的多行代码")
}
​```
下面的代码块中每行前面都有一个制表符（缩进）。
    while(1)
    {
        printf("这是一段C语言的多行代码")
    }

Typora只支持GitHub风格的Markdown 围栏 （如上面代码区块周围的围栏），原始的Markdown代码块标记是不支持显示围栏的。

在Typora中，只需要输入 ```+Return 即可创建一个代码区块（围栏），也可在 ``` 后面加上代码的语言。

数学区块（数学公式）

注意注意，重点来了哦

数学公式的书写往往很麻烦，但是在Markdown中可以十分便捷地书写出来。Markdown采用MathJax语法进行简洁高效的数学公式编辑，呈现出$L^A{T}_{E}X$的数学表达形式。

插入公式

• 行内公式，使用 $公式$ 的格式在行中插入公式
• 行间公式，多行公式使用 $$…$$ 格式在行间插入公式

例如：

这里使用 $\vec{a} \centerdot \vec{b} = |a||b|cos(\theta)$ 公式。
下面是行间公式：
$$
\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} \tag{1.2}
$$

（ times 倍，乘以； boldface 黑体，粗体； fraction 分式； partial 部分的，偏颇 ）

显示结果：

这里使用 $\vec{a}\cdot \vec{b}=|a||b|cos(\theta )$ 公式。

下面是行间公式：
$${\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|\text{\hspace{1em}(1.2)}$$

另外，使用 \tag 命令可以手动添加公式序号。

**而且！！**Typora中，在“偏好设置(preference)”，“数学公式”后面可以找到“自动添加序号”条目，勾选后重启Typora即可生效，实现数学公式自动添加序号。

开启自动添加序号后，每个 行间公式 会自动添加序号，但 行内公式 不会受到影响。当 行间公式 里有多个公式的时候，要使用排列格式，这时对齐区域内的每一个换行符号对应一个序号。

当使用 \begin{align*} \end{align*} 时，表示该区域公式不需编号。

上下标

上标使用^，下标使用_。多个上下标字符使用小括号{}括起来。例如：

$$
y = f_1^2(x^{e^2})
$$

$$y=f_1^2(x^{e^2})$$

如果符号两边都要加上下标，可以使用\sideset命令。\sideset{1}{2}{3} 参数1、2、3分别为左、右、中位置的符号，例如：

$$
\sideset{^{左上}_{左下}}{^{右上}_{右下}}{中}
$$

KaTeX parse error: Undefined control sequence: \sideset at position 2: \̲s̲i̲d̲e̲s̲e̲t̲{^{左上}_{左下}}{^{…

括号与分隔符

()，[]，|用符号本身表示，{}使用反斜杠\转义来表示，如此\{\}。

大括号或者分隔符要用到 \left \right 命令。例如：

$$
f(x) = \left( x + \frac{2}{x^2} + \frac{3}{x^3} \over e \right)
$$

显示如下：
$$f(x)=\left(\frac{x+\frac{2}{x^2}+\frac{3}{x^3}+}{e}\right)$$

**\left和\right成对出现**，所以有时需要\left.或者\right.` 这两个不显示 的命令去补全。例如：

$$
a = \left. \frac {
  
  {\rm d}u}{
  
  {\rm d}t} \right |_{t=1}
$$

显示如下：
$$a={\frac{\mathrm{d}u}{\mathrm{d}t}|}_{t=1}$$

注： \rm 命令使其后的一个字符显示为印刷字体，例 \rm a 显示为 $\mathrm{a}$ ， a 显示为 $a$ 。

一些特殊的括号：

分式

分式使用\frac， \over 命令。（ fraction：分式 ）

• \frac abc表示 $\frac{a}{b}c$ ，即\frac后面分别依次为分子和分母
• abcd \over efg 表示 $\frac{abcd}{efg}$ ，即\over之前全部为分子，之后全部为分母

例如：

$$
y_1 = \frac ab + \frac {a^2}{b^2} + \frac cde \over {\rm e} \tag{1}
$$
$$
y_2 = {
  
  {a \over b} \over {\frac cd}} \tag{2}
$$

显示结果：
$$\frac{y_1=\frac{a}{b}+\frac{a^2}{b^2}+\frac{c}{d}e}{\mathrm{e}}\text{\hspace{1em}(1)}$$

$$y_2=\frac{\frac{a}{b}}{\frac{c}{d}}\text{\hspace{1em}(2)}$$

显然，式(1)中的 $y_1 = $ 也因为 \over 被作为了分子，放在了分子的位置上；而式(2)中添加了 $\left\{\genfrac{}{}{0ex}{}{}{}\right\}$ 限制了 \over 的范围，得到了正确的效果。

矩阵、排列（对齐）

在书写公式的时候，我们通过排版使形式美观，内容分明。

• 使用 \begin{keyword} \end{keyword} 命令创建一个特定格式区域
• 关键词keyword有align、matrix、vmatrix、bmatrix、pmatrix等
• \\命令，换行，在任何区域都能使用
• &命令，对齐或分隔，具体作用在不同区域略有不同

例如：

$$
	\left \{ 
		\begin{align}
			& \begin{bmatrix}
			a_1 & b_1 & c_1 \\
			a_2 & b_2 & c_2 \\
			a_3 & b_3 & c_3 
			\end{bmatrix} = 
			\begin{pmatrix}
			x_1 \\ x_2 \\ x_3
			\end{pmatrix}
			\begin{bmatrix}
			1 &   &   \\
			  & 1 &   \\
			  &   & 1 
			\end{bmatrix}
			\\
			& \begin{vmatrix}
			a_1 & b_1 & c_1 \\
			a_2 & b_2 & c_2 \\
			a_3 & b_3 & c_3 
			\end{vmatrix}
			= \lambda^3
             \\ 
             & W = U + V
		\end{align}
	\right.
	\tag{3}
$$

显示结果为：
{ [ a 1 b 1 c 1 a 2 b 2 c 2 a 3 b 3 c 3 ] = ( x 1 x 2 x 3 ) [ 1 1 1 ] ∣ a 1 b 1 c 1 a 2 b 2 c 2 a 3 b 3 c 3 ∣ = λ 3 W = U + V (3) \left \{ \begin{aligned} & \begin{bmatrix} a_1 & b_1 & c_1 \\ a_2 & b_2 & c_2 \\ a_3 & b_3 & c_3 \end{bmatrix} = \begin{pmatrix} x_1 \\ x_2 \\ x_3 \end{pmatrix} \begin{bmatrix} 1 & & \\ & 1 & \\ & & 1 \end{bmatrix} \\ & \begin{vmatrix} a_1 & b_1 & c_1 \\ a_2 & b_2 & c_2 \\ a_3 & b_3 & c_3 \end{vmatrix} = \lambda^3 \\ & W = U + V \end{aligned} \right. \tag{3} ⎩⎪⎪⎪⎪⎪⎪⎪⎪⎪⎨⎪⎪⎪⎪⎪⎪⎪⎪⎪⎧​​⎣⎡​a1​a2​a3​​b