🏠 回到主页

Typora使用文档与Markdown语法学习

typora使用文档

介绍

本文是一份typora使用手册，内容包括常用语法功能，官方使用手册以及软件快捷键。可用于学习markdown语法。

本文下载地址：Typora使用帮助

关于Typora

Typora是一款简洁高效的Markdown编辑器。它结合了编辑和预览功能，提供所见即所得的编辑体验。用户可以在一个窗口中实时查看Markdown文档的最终效果。Typora支持多种导出格式和丰富的快捷键，适用于需要编写和管理Markdown文档的用户。它还支持跨平台操作，包括Windows、macOS和Linux。

1. 直观：Typora的界面设计简洁直观，用户很容易上手。

2. 实时预览：支持实时Markdown预览，在编辑过程中实时查看效果。

3. 所见即所得：Typora将编辑和预览合二为一，提供所见即所得的编辑体验。

4. 支持多种格式：支持导出成多种格式，如PDF、HTML、Word等。

5. 快捷键：提供丰富的快捷键，提高编辑效率。

6. 扩展性：支持自定义CSS，用户可以根据需要调整样式。

7. 跨平台：支持Windows、macOS和Linux操作系统。

8. 易于组织：内置大纲视图和文件管理器，方便管理文档结构。

Typora是一款非常优秀的Markdown笔记软件，尤其拿来记代码方面的片段非常合适，MD语法非常方便上手，能够减少排版烦恼。不过该软件是付费的，可以在淘宝找官方授权商购买会比较便宜。

建议将本工具文档使用Typora软件打开以获得最好的浏览效果。因为部分Typora语法与一些平台的md格式解析出来的样式不太一样。

一些常用整理的内容

参考链接

菜鸟md教程https://www.runoob.com/markdown/md-advance.html

插入表格：|x|y|+Enter

复选框语法- [ ] +文字内容

• 这是一个check box示例

• 这是一个check box示例

文本折叠

xxxxxxxxxx
4
1
<details>
2
  <summary>点击时的区域标题：点击查看详细内容</summary>
3
填一些文本，不适合写代码因为没有语法高亮
4
</details>

#define A B
#endif
void init(void)

字体字号颜色

xxxxxxxxxx
6
1
<font face="黑体">我是黑体字</font>
2
<font face="微软雅黑">我是微软雅黑</font>
3
<font face="STCAIYUN">我是华文彩云</font>
4
<font color=#0099ff size=12 face="黑体">黑体</font>
5
<font color=gray size=5>gray</font>
6
<font color=#00ffff size=3>null</font>

我是黑体字 我是微软雅黑 我是华文彩云 黑体 gray null

提醒框

xxxxxxxxxx
3
1
> [!NOTE]
2
>
3
> 

xxxxxxxxxx
3
1
> [!TIP]
2
>
3
> 

xxxxxxxxxx
3
1
> [!IMPORTANT]
2
>
3
> 

xxxxxxxxxx
3
1
> [!WARNING]
2
>
3
> 

xxxxxxxxxx
3
1
> [!CAUTION]
2
>
3
> 

官方书册概述

Markdown 由 Daring Fireball 创建，原始指南在 这里。但是，它的语法因不同的解析器或编辑器而异。Typora 正在使用 GitHub Flavored Markdown。

块元素

段落和换行符

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

按 Shift + Return 可创建单个换行符。但是，大多数 markdown 解析器将忽略单行中断，要使其他 markdown 解析器识别您的换行符，可以在行尾留下两个空格，或者插入 <br/>.

标题

标题在行的开头使用1-6个＃字符，对应于标题级别1-6。例如：

xxxxxxxxxx
5
1
 # 这是一级标题
2

3
## 这是二级标题
4

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

在typora中，输入’＃’后跟标题内容，按下 Return 键将创建标题。

引用文字

Markdown 使用电子邮件样式>字符进行块引用。它们表示为：

xxxxxxxxxx
7
1
> 这是一个有两段的块引用。这是第一段。
2
>
3
> 这是第二段。Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, risus.
4

5

6

7
> 这是另一个只有一个段落的块引用。有三个空行分隔两个块引用。

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

列表

输入 * list item 1 将创建一个无序列表，该 * 符号可以替换为 + 或 -.

输入 1. list item 1 将创建一个有序列表，其 markdown 源代码如下：

xxxxxxxxxx
9
1
## 无序列表
2
*   红色
3
*   绿色
4
*   蓝色
5

6
## 有序列表
7
1.  红色
8
2.  绿色
9
3.  蓝色

任务列表

任务列表是标记为[ ]或[x]（未完成或完成）的项目的列表。例如：

xxxxxxxxxx
5
1
- [ ] 这是一个任务列表项
2
- [ ] 需要在前面使用列表的语法
3
- [ ] normal **formatting**, @mentions, #1234 refs
4
- [ ] 未完成
5
- [x] 完成

您可以通过单击项目前面的复选框来更改完成/未完成状态。

（栅栏式）代码块

Typora仅支持 Github Flavored Markdown 中的栅栏式代码块。不支持 markdown 中的原始代码块。

使用栅栏式代码块很简单：输入``之后输入一个可选的语言标识符，然后按return`键后输入代码，我们将通过语法高亮显示它：

xxxxxxxxxx
14
1
这是一个例子：
2

3
```
4
function test() {
5
  console.log("notice the blank line before this function?");
6
}
7
```
8

9
语法高亮：
10
```ruby
11
require 'redcarpet'
12
markdown = Redcarpet.new("Hello World!")
13
puts markdown.to_html
14
```

数学公式块

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

输入 $$, 然后按“return”键将触发一个接受Tex / LaTex源代码的输入区域。以下是一个例子：

在 markdown 源文件中，数学公式块是由’$$’标记包装的 LaTeX 表达式：

xxxxxxxxxx
7
1
$$
2
\mathbf{V}_1 \times \mathbf{V}_2 =  \begin{vmatrix} 
3
\mathbf{i} & \mathbf{j} & \mathbf{k} \\
4
\frac{\partial X}{\partial u} &  \frac{\partial Y}{\partial u} & 0 \\
5
\frac{\partial X}{\partial v} &  \frac{\partial Y}{\partial v} & 0 \\
6
\end{vmatrix}
7
$$

表格

输入 | First Header | Second Header | 并按下 return 键将创建一个包含两列的表。

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

可以跳过以下描述，因为表格的 markdown 源代码是由typora自动生成的。

在 markdown 源代码中，它们看起来像这样：

xxxxxxxxxx
4
1
| First Header  | Second Header |
2
| ------------- | ------------- |
3
| Content Cell  | Content Cell  |
4
| Content Cell  | Content Cell  |

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

最后，通过在标题行中包含冒号：您可以将文本定义为左对齐，右对齐或居中对齐：

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

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

脚注

xxxxxxxxxx
3
1
您可以像这样创建脚注[^footnote].
2

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

将产生：

您可以像这样创建脚注1.

鼠标移动到‘footnote’上标中查看脚注的内容。

水平线

输入 *** 或 --- 在空行上按 return 键将绘制一条水平线。

YAML Front Matter

Typora 现在支持 YAML Front Matter 。 在文章顶部输入 --- 然后按 Enter 键将引入一个，或者从菜单中插入一个元数据块。

目录 (TOC)

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

图表 (Sequence, Flowchart and Mermaid)

Typora 支持, sequence, flowchart and mermaid, 使用前要先从偏好设置面板启用该功能。

详细信息请参阅此 文档

Span 元素

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

链接

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

在这两种样式中，链接文本都写在[方括号]内。

要创建内联链接，请在链接文本的结束方括号后立即使用一组常规括号。在常规括号内，输入URL地址，以及可选的用引号括起来的链接标题。例如：

xxxxxxxxxx
3
1
This is [an example](http://example.com/ "Title") inline link.
2

3
[This link](http://example.net/) has no title attribute.

将产生：

This is an example inline link. (<p>This is <a href="http://example.com/" title="Title">)

This link has no title attribute. (<p><a href="http://example.net/">This link</a> has no)

内部链接

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

Command(在Windows上：Ctrl) + 单击 此链接 将跳转到标题 块元素处。 要查看如何编写，请移动光标或按住 ⌘ 键单击以将元素展开为 Markdown 源代码。

参考链接

参考样式链接使用第二组方括号，在其中放置您选择的标签以标识链接：

xxxxxxxxxx
5
1
This is [an example][id] reference-style link.
2

3
然后，在文档中的任何位置，您可以单独定义链接标签，如下所示：
4

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

在typora中，它们将呈现为：

This is an example reference-style link.

隐式链接名称快捷方式允许您省略链接的名称，在这种情况下，链接文本本身将用作名称。只需使用一组空的方括号，例如，将“Google”一词链接到google.com网站，您只需写下：

xxxxxxxxxx
4
1
[Google][]
2
然后定义链接：
3

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

在typora中单击链接将其展开以进行编辑，command + 单击将在 Web 浏览器中打开超链接。

URL网址

Typora允许您将 URL 作为链接插入，用 <括号括起来>。

<i@typora.io> 成为 i@typora.io.

Typora也将自动链接标准URL。例如： www.google.com.

图片

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

xxxxxxxxxx
5
1
![替代文字](/path/to/img.jpg)
2

3
![替代文字](/path/to/img.jpg "可选标题")
4

5
<img src="../path/to/img.jpg" width=50%/>

您可以使用拖放操作从图像文件或浏览器来插入图像。并通过单击图像修改 markdown 源代码。如果图像在拖放时与当前编辑文档位于同一目录或子目录中，则将使用相对路径。

有关图像的更多提示，请阅读 http://support.typora.io//Images/

强调（斜体）

Markdown 将星号 (*) 和下划线(_) 视为强调的指示。用一个 * or _ 包裹文本将使用HTML <em> 标签包裹文本。例如：

xxxxxxxxxx
3
1
*单个星号*
2

3
_单个下划线_

输出：

单个星号

单个下划线

GFM将忽略单词中的下划线，这通常用在代码和名称中，如下所示：

wow_great_stuff

do_this_and_do_that_and_another_thing.

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

xxxxxxxxxx
1
1
\*这个文字被文字星号包围\*

Typora建议使用 * 号.

粗体

用两个 * 或 _ 包裹的文本将使用HTML <strong> 标签包裹，例如：

xxxxxxxxxx
3
1
**双星号**
2

3
__双重下划线__

输出：

双星号

双重下划线

Typora 建议使用 ** 号。

代码

要指示代码范围，请使用反引号（`）进行包裹。与预格式化的代码块不同，代码跨度表示正常段落中的代码。例如：

xxxxxxxxxx
1
1
使用`printf()`函数。

将产生：

使用 printf() 函数。

删除线

GFM通过添加语法来创建删除线文本，标准的Markdown中缺少该文本。

~~错误的文字。~~ 变成 错误的文字。

下划线

下划线由原始HTML提供支持。

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

表情符号 😄

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

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

内联数学公式

要使用此功能，首先，请在 偏好设置 面板 -> Markdown扩展语法 选项卡中启用它。然后使用 $ 来包裹TeX命令，例如： $\lim_{x \to \infty} \exp(-x) = 0$ 将呈现为LaTeX命令。

要触发内联公式的预览提示功能：输入“$”, 然后按 ESC 键, 然后输入TeX命令, 预览工具提示将如下所示：

下标

要使用此功能，首先，请在 偏好设置 面板 -> Markdown扩展语法 选项卡中启用它。然后用 ~ 来包裹下标内容，例如： H~2~O, X~long\ text~/

上标

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

高亮

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

HTML

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

嵌入内容

有些网站提供基于iframe的嵌入代码，您也可以将其粘贴到Typora中，例如：

xxxxxxxxxx
1
1
<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> HTML标记嵌入视频，例如：

xxxxxxxxxx
1
1
<video src="xxx.mp4" />

其他 HTML 支持

你可以在 这里找到细节。

1. Here is the text of the footnote. ↩

常用快捷键

文件

编辑

段落

格式

界面