Markdown与Typora学习笔记

typora使用文档

介绍

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

关于Typora

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

直观：Typora的界面设计简洁直观，用户很容易上手。
实时预览：支持实时Markdown预览，在编辑过程中实时查看效果。
所见即所得：Typora将编辑和预览合二为一，提供所见即所得的编辑体验。
支持多种格式：支持导出成多种格式，如PDF、HTML、Word等。
快捷键：提供丰富的快捷键，提高编辑效率。
扩展性：支持自定义CSS，用户可以根据需要调整样式。
跨平台：支持Windows、macOS和Linux操作系统。
易于组织：内置大纲视图和文件管理器，方便管理文档结构。

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

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

一些常用整理的内容

参考链接

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

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

x	y

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

这是一个check box示例
这是一个check box示例

文本折叠

点击时的区域标题：点击查看详细内容

填一些文本，不适合写代码因为没有语法高亮

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

点击时的区域标题：点击查看详细内容

#define A B
#endif
void init(void)

字体字号颜色

Text Only

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

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

提醒框

[!NOTE]
Text Only
1
2
3
> [!NOTE]
>
> 
[!TIP]
Text Only
1
2
3
> [!TIP]
>
> 
[!IMPORTANT]
Text Only
1
2
3
> [!IMPORTANT]
>
> 
[!WARNING]
Text Only
1
2
3
> [!WARNING]
>
> 
[!CAUTION]
Text Only
1
2
3
> [!CAUTION]
>
> 

官方书册概述

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

块元素

段落和换行符

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

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

标题

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

Text Only
1 2 3 4 5	`# 这是一级标题 ## 这是二级标题 ###### 这是六级标题`

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

引用文字

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

Text Only

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



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

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

列表

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

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

Text Only
1 2 3 4 5 6 7 8 9	`## 无序列表 * 红色 * 绿色 * 蓝色 ## 有序列表 1. 红色 2. 绿色 3. 蓝色`

任务列表

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

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

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

（栅栏式）代码块

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

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

Text Only

这是一个例子：

```
function test() {
  console.log("notice the blank line before this function?");
}
```

语法高亮：
```ruby
require 'redcarpet'
markdown = Redcarpet.new("Hello World!")
puts markdown.to_html
```

数学公式块

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

输入 $$, 然后按“return”键将触发一个接受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} $$

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

Text Only

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

表格

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

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

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

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

Text Only
1 2 3 4	`\| First Header \| Second Header \| \| ------------- \| ------------- \| \| Content Cell \| Content Cell \| \| Content Cell \| Content Cell \|`

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

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

Text Only

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

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

脚注

Text Only
1 2 3	`您可以像这样创建脚注[^footnote]. [^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地址，以及可选的用引号括起来的链接标题。例如：

Text Only
1 2 3	`This is [an example](http://example.com/ "Title") inline link. [This link](http://example.net/) has no title attribute.`

将产生：

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

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

内部链接

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

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

参考链接

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

Text Only
1 2 3 4 5	`This is [an example][id] reference-style link. 然后，在文档中的任何位置，您可以单独定义链接标签，如下所示： [id]: http://example.com/ "Optional Title Here"`

在typora中，它们将呈现为：

This is an example reference-style link.

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

Text Only
1 2 3 4	`[Google][] 然后定义链接： [Google]: http://google.com/`

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

URL网址

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

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

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

图片

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

Text Only
1 2 3 4 5	`![替代文字](/path/to/img.jpg) ![替代文字](/path/to/img.jpg "可选标题") <img src="../path/to/img.jpg" width=50%/>`

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

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

强调（斜体）

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

Text Only
1 2 3	`单个星号 _单个下划线_`

输出：

单个星号

单个下划线

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

wow_great_stuff

do_this_and_do_that_and_another_thing.

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

Text Only
1	`\这个文字被文字星号包围\`

Typora建议使用 * 号.

粗体

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

Text Only
1 2 3	`双星号 __双重下划线__`

输出：

双星号

双重下划线

Typora 建议使用 ** 号。

代码

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

Text Only
1	使用`printf()`函数。

将产生：

使用 printf() 函数。

删除线

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

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

下划线

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

下划线 变成下划线

表情符号

输入表情符号的语法是 :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 不支持的内容，例如， this text is red 用于添加红色文本。

嵌入内容

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

Markdown

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

Markdown
1	`<video src="xxx.mp4" />`

其他 HTML 支持

你可以在这里找到细节。

Here is the text of the footnote. ↩

常用快捷键

文件

功能	热键 (Windows/Linux)	热键 (macOS)
新的文件	Ctrl + N	Command + N
新窗户	Ctrl + Shift + N	Command + Shift + N
新标签	（不支持）	Command + T
打开	Ctrl + O	Command + O
快速打开	Ctrl + P	Command + Shift + O
重新打开关闭的文件	Ctrl + Shift + T	Command + Shift + T
保存	Ctrl + S	Command + S
另存为/复制	Ctrl + Shift + S	Command + Shift + S
偏爱设置	Ctrl + ,	Command + ,
关闭	Ctrl + W	Command + W

编辑

功能	热键 (Windows/Linux)	热键 (macOS)
新段落	Enter	Enter
新的行	Shift + Enter	Shift + Enter
剪切	Ctrl + X	Command + X
复制	Ctrl + C	Command + C
粘贴	Ctrl + V	Command + V
复制为 Markdown	Ctrl + Shift + C	Command + Shift + C
粘贴为纯文本	Ctrl + Shift + V	Command + Shift + V
全选	Ctrl + A	Command + A
选择行/句子选择行（在表格中）	Ctrl + L	Command + L
删除行（在表中）	Ctrl + Shift + Backspace	Command + Shift + Backspace
选择样式范围选择单元格（在表格中）	Ctrl + E	Command + E
选择单词	Ctrl + D	Command + D
删除单词	Ctrl + Shift + D	Command + Shift + D
跳到顶部	Ctrl + Home	Command + ↑
跳转到选择	Ctrl + J	Command + J
跳到底部	Ctrl + End	Command + ↓
查找	Ctrl + F	Command + F
找下一个	F3 / Enter	Command + G / Enter
查找上一个	Shift + F3 / Shift + Enter	Command + Shift + G / Shift + Enter
代替	Ctrl + H	Command + H

段落

功能	热键 (Windows/Linux)	热键 (macOS)
标题 1 到 6	Ctrl + 1/2/3/4/5/6	Command + 1/2/3/4/5/6
标题变为普通段落	Ctrl + 0	Command + 0
增加标题级别	Ctrl + =	Command + =
降低标题级别	Ctrl + -	Command + -
插入表格	Ctrl + T	Command + Option + T
代码围栏	Ctrl + Shift + K	Command + Option + C
数学块	Ctrl + Shift + M	Command + Option + B
引用	Ctrl + Shift + Q	Command + Option + Q
有序列表	Ctrl + Shift + [	Command + Option + O
无序列表	Ctrl + Shift + ]	Command + Option + U
向前缩进	Ctrl + [ / Tab	Command + [ / Tab
向后缩进	Ctrl + ] / Shift + Tab	Command + ] / Shift + Tab

格式

功能	热键 (Windows/Linux)	热键 (macOS)
加粗	Ctrl + B	Command + B
斜体	Ctrl + I	Command + I
下划线	Ctrl + U	Command + U
代码	Ctrl + Shift + \| Command + Shift +
删除线	Alt + Shift + 5	Control + Shift + `
超链接	Ctrl + K	Command + K
图像	Ctrl + Shift + I	Command + Command + I
清除格式	Ctrl + \	Command + \

界面

功能	热键 (Windows/Linux)	热键 (macOS)
切换侧边栏	Ctrl + Shift + L	Command + Shift + L
大纲	Ctrl + Shift + 1	Command + Command + 1
文章	Ctrl + Shift + 2	Command + Command + 2
文件树	Ctrl + Shift + 3	Command + Command + 3
源代码模式	Ctrl + /	Command + /
对焦模式	F8	F8
打字机模式	F9	F9
切换器全屏	F11	Command + Option + F
真实大小	Ctrl + Shift + 0	（不支持）
放大	Ctrl + Shift + =	（不支持）
缩小	Ctrl + Shift + -	（不支持）
在打开的文档之间切换	Ctrl + Tab	Command + `
Toggle 开发者工具	Ctrl + Shift + I	——

Markdown与Typora学习笔记

介绍

关于Typora

一些常用整理的内容

参考链接

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

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

文本折叠

字体字号颜色

提醒框

官方书册概述

块元素

段落和换行符

标题

引用文字

列表

任务列表

（栅栏式）代码块

数学公式块

表格

脚注

水平线

YAML Front Matter

目录 (TOC)

图表 (Sequence, Flowchart and Mermaid)

Span 元素

链接

内部链接

参考链接

URL网址

图片

强调（斜体）

粗体

代码

删除线

下划线

表情符号

内联数学公式

下标

上标

高亮

HTML

嵌入内容

视频

其他 HTML 支持

常用快捷键

文件

编辑

段落

格式

界面

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