Typora: Markdown Reference (Typora下Markdown语法使用说明)

2023-07-17 13:05:10

引言

由于一直在使用Typora，这个是我使用过的最棒的Markdown编辑器，但是总是忽略某一个功能，于是决定认真看一下其帮助文档
这里做一个简单主要功能的中文翻译(按键对应Windows下)。
原文链接→传送门，感谢作者。

标题(Headers)

标题的书写方式为:在行的开头用1~6个#,来对应表示标题1到标题6

# 这是一级标题

## 这是二级标题

### 这是三级标题

在Typora中，输入#之后直接输入内容，再按Enter键，将会创建一个标题。或者按Ctrl+1(1_{6)创建一级标题（1}6级标题），或者在输入行右击→段落→对应标题。

引用(Blockquotes)

Markdown使用>字符来表示块的引用，具体如下：

> 这是两段的引用，这是第一段

>

> 这是第二段

> 这是另外一段只有一段的引用。两个引用之间有三个空行用来分割不同的引用。

在Typora中，输入>，随后输入内容，即可生成一个引用。Typor将会为你插入正确的>或者分割线。嵌套的块引用（一个块引用在另一个块引用中）的情况，可以在引用中添加额外的>来区分表示。

列表(Lists)

输入*(或者-/+)，和一个空格，将会产生一个无序列表。
输入1.和一个空格，将会产生一个有序列表。
例如：

## 无序列表

- 红

- 绿

- 蓝

## 有序列表

1. 红

2. 绿

3. 蓝

任务列表(Task List)

任务列表是用来表示任务是否完成的（- [ ]:未完成，- [x]已经完成）
示例：

- [ ] 未完成任务项

- [x] 已经完成任务项

可以通过点击复选框来改变是否完成的状态
经过我的试验，直接在Typora中输入- [ ]来触发显示复选框，不太容易实现（因为总是会先解析-为无序列表），建议右击，点击来实现。

代码块((Fenced) Code Blocks)

Typora仅在Github Flavored Markdown中支持栅栏样式，并不是代码的原始样式。
使用栅栏格式的代码块很简单：输入```,按下Enter键,随后可以在栅栏右下角选择对应的代码语言。也可以在```后面输入代码语言名字（python等）。之后就会有对应的语法高亮。
示例：

数学公式(Math Blocks)

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

$$

可以在这里发现更多的细节。

表格(Tables)

输入| First Header | Second Header |, 按下Enter键。将会生成一个两列的表格。
当产生一个表格后，将鼠标放在表格上，，将会在表格上方产生一个工具框，可以通过它来设置表格大小，对齐单元格或者删除表格。也可以使用context菜单来删除或添加一行/一列。
全部的表格语法见下方，这并不是必须知道的。可以通过右击→插入→表格,其他的Typora会自动生成。

| First Header  | Second Header |

| ------------- | ------------- |

| Content Cell  | Content Cell  |

| Content Cell  | Content Cell  |

同时可以对表格中某个单元格字体设置加粗、斜体或者删除线等
通过在标题行下面添加：，来设置该列是左对齐、右对齐或者居中

| Left-Aligned  | Center Aligned  | Right Aligned |

| :------------ |:---------------:| -----:|

| col 3 is      | some wordy text | $1600 |

| col 2 is      | centered        |   $12 |

| zebra stripes | are neat        |    $1 |

脚注(Footnotes)

具体脚注添加方法如下：

You can create footnotes like this[^fn1] and this[^fn2].

[^fn1]: Here is the *text* of the first **footnote**.

[^fn2]: Here is the *text* of the second **footnote**.

鼠标放在'fn1'或者'fn2'上，可以看到脚注的内容。可以使用任何标识符来标明是脚注。
可以创建内嵌脚注，像this^[1]（这个没有看太懂-_-）

横线（分割线）(Horizontal Rules)

在空白行输入***或者---，按Enter键将会画一个横分割线。

YAML Front Matter

在文章顶部，输入---，按下Enter键，即可产生metadata块。
当然也可以右击→插入→YAML Front Matter。

目录(Table of Contents (TOC))

输入[TOC]，按下Enter键，将会将文中的标题按照层级生成目录，并且自动更新

跨度元素（Span Elements）

跨度元素在键入后立即将解析并渲染。并且将光标放在Span Elements中间时，将会自动显示为Markdown源码。

超链接(Links)

Markdown支持两种格式超链接：内嵌式和参考式。

内嵌式超链接（Internal Links）

内嵌式超链接可以看作一个页内书签，类似于Word中对图表的交叉引用
按住Ctrl，左键点击相应链接，就可以跳到相应标题下。

Hold down Cmd (on Windows: Ctrl) and click on [this link](#block-elements) to jump to header `Block Elements`.

参考式超链接(Reference Links)

这个比较常用，就是给指定文字添加超链接
具体写法如下：

这个一个[参考式超链接](http://example.com/ "标题")的例子

在Typora中，单击这个超链接，将会为可编辑的超链接的源码。按住Ctrl+左键单击将会使用默认浏览器打开这个超链接。

URL

在Typora中，可以在<>中放入URL,例如i@typora.io,就会被解析为带有下划线的i@typora.io

图像(Images)

图像的插入和插入超链接有着相似的语法，但是插入图像要求在图像链接前插入一个额外的!，插入语法类似于如下：

![描述文本(可选)](/path/to/img.jpg)

![描述文本(可选)](/path/to/img.jpg "标题")

在Typora中，可以采取拖曳方式从本地或者浏览器上插入图像，也可以通过点击图像来修改图像路径。如果添加的图像所在路径和编辑文件为同一目录，则图像的路径为相对路径。
如果使用Markdown来构建网站，可以通过YAML Front Matter中添写typora-root-url来指定本地图像的前缀。
例如：在YAML Front Matter中输入typora-root-url:/User/Abner/Website/typora.io/，之后插入图像![alt](/blog/img/test.png)，在Typora中将会变为![alt](file:///User/Abner/Website/typora.io/blog/img/test.png)。

强调(Emphasis)

Markdown中将*和_作为强调的标志符号。如果文本用*或者_包围，则会被解析为HTML中的,例如：

*single asterisks*

_single underscores_

结果如下：

single asterisks

single underscores

如果想要用*和_,则可以在*和_加\
Typora中推荐使用*。

加粗(Strong)

两个**或者__包围的文本将会对其加粗，解析为HTML中的标签
例如：

**double asterisks**

__double underscores__

结果如下：

double asterisks

double underscores
Typora中推荐使用**

代码(Code)

为了表明行间的代码，使用``将其包围。
例子：

删除线(Strikethrough)

两个~~将文本包围，将会产生删除线

Emoji:happy

输入:将会触发Emoji表情。
例如， :happy:将会产生

行内公式(Inline Math)

如果想要使用该功能，需要先设置为能用，如下：
使用$来包围要写的公式，例如：
为了触发行内公式的预览，可以先输入'$',按ESC键。
了解详情

下角标/上角标/高亮

下角标：H₂O
上角标：X²
高亮：highlight

HTML

可以通过添加HTML来添加Markdown不支持的格式。
例如：

 <span style="color:red">this text is red</span>

下划线

下划线在GFM的Markdown中并不支持，但是可以通过HTML来添加
例如：

嵌入内容(Embed Contents)

一些网站提供基于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标签来嵌入视频，也可以直接拖曳。
例如：

<video src="xxx.mp4"/>

结果如下：

其它支持的HTML

参考链接

写在最后：本文涉及到的大部分Markdown语法都是通用的，本文使用的就是Markdown编辑器写成的。文中如果有什么问题，可以指出。

Here is the text of the first footnote. ↩︎

码农公寓

引言