📄 2.1 段落与换行#

段落 = 连续的一行或多行文字。

1
这是第一段文字。
2

3
这是第二段文字（段落之间用空行隔开）。

⚠️ 注意：大多数Markdown解析器会忽略单独的回车换行，所以跨平台写作时，建议行尾加两个空格或使用 <br/>。

📑 2.2 标题（Headings）#

用 # 号开头，1~6个井号 = 1~6级标题。井号后面要加一个空格再写标题内容。

1
# 一级标题
2
## 二级标题
3
### 三级标题
4
#### 四级标题
5
##### 五级标题
6
###### 六级标题

效果：

一级标题（最大）#

二级标题#

三级标题#

…

六级标题（最小）#

Typora小技巧：输入井号+标题文字+回车，自动生成标题。

建议：一篇文章只用1个一级标题（通常是文章主标题），下级标题规范地使用二三四级，不要跳级（比如三级后面直接跟五级）。

💬 2.3 引用（Blockquotes）#

用 > 符号开头，表示引用别人的话或内容。

1
> 这是引用内容的第一行。
2
>
3
> 这是引用的第二行。
4

5
> 这是另一个引用段落。

效果：

这是引用内容的第一行。

这是引用的第二行。

嵌套引用：多加一个 > 就行

1
> 外层引用内容
2
>
3
> > 内层嵌套引用

外层引用内容

内层嵌套引用

💡 Tip：引用里也可以嵌套标题、列表、代码块等，不过别嵌套太深，最多2~3层就够了。

📋 2.4 列表（Lists）#

1
* 苹果
2
* 香蕉
3
* 草莓

1
- 苹果
2
- 香蕉
3
- 草莓

1
1. 第一步
2
2. 第二步
3
3. 第三步

1
- 水果
2
  - 苹果
3
    - 红富士
4
    - 嘎啦
5
  - 香蕉
6
- 蔬菜
7
  1. 白菜
8
  2. 萝卜

✅ 2.5 任务列表（Task List）#

GFM特有的语法，用 [ ]（未完成）和 [x]（已完成）：

1
- [ ] 写Markdown笔记
2
- [ ] 发博客
3
- [x] 搞定Mermaid语法
4
- [ ] 复习单词 🔥
5
- [x] 今天吃了火锅

效果：

• 写Markdown笔记
• 发博客
• 搞定Mermaid语法
• 复习单词 🔥
• 今天吃了火锅

💡 Typora中：点击复选框可以直接切换完成/未完成状态，超方便！ 也可以和普通列表混着用，比如嵌套在有序列表里。

💻 2.6 代码块（Fenced Code Blocks）#

用三个反引号 ``` 包裹代码块。强烈建议加上语言名称，这样会自动语法高亮！

1
```python
2
def hello():
3
    print("Hello, Markdown!")
4
```
5

6
```javascript
7
function hello() {
8
    console.log("Hello, Markdown!");
9
}
10
```
11

12
```css
13
body {
14
    background: #f0f0f0;
15
    color: #333;
16
}
17
```
18

19
```bash
20
echo "Hello, Markdown!"
21
```

Typora小技巧：输入三个反引号 ``` 后按回车，自动生成代码块框。

⚠️ 支持的编程语言：js / javascript, py / python, html, css, bash / shell, java, c, cpp, ruby, go, rust, sql, json, yaml, xml, diff, markdown 等数十种。

行内代码（见后文行内元素部分）用于在段落中高亮单个代码词汇。

➗ 2.7 数学公式块（Math Blocks）#

用 $$ 包裹 LaTeX数学表达式：

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

渲染效果（支持MathJax引擎）：

常用LaTeX数学符号速查：

💡 Typora步骤：输入 $$ + 回车 → 自动弹出数学编辑框 → 输入LaTeX代码即可。

📊 2.8 表格（Tables）#

Markdown表格语法在Typora中可以自动生成，也可以手写：

1
| 姓名 | 年龄 | 爱好 |
2
|------|------|------|
3
| 火花花 | 18 | 写博客、吃火锅 |
4
| 仙贝 | ？ | 摸鱼、学习 |

效果：

1
| 左对齐 | 居中对齐 | 右对齐 |
2
|:-------|:--------:|-------:|
3
| 内容1 | 内容2 | 内容3 |
4
| 左对齐 | 居中 | 右对齐 |

📌 2.9 脚注（Footnotes）#

在正文要注释的地方写 [^标签名]，然后在文档末尾或任意位置定义脚注内容：

1
Markdown是一个很牛的工具[^md]。
2

3
[^md]: Markdown由John Gruber于2004年创建，是一种轻量级标记语言。

效果： Markdown是一个很牛的工具¹。

💡 鼠标悬停在脚注编号上可以看到内容预览。

➖ 2.10 分割线（Horizontal Rules）#

空行中输入 *** 或 --- 或 ___ 然后回车：

1
这是上面内容
2

3
***
4

5
这是下面内容

效果：

⚠️ 注意：--- 也是YAML元数据的分隔符。如果写在文档最开头，会被识别为YAML。建议正文中用 *** 或 ___ 来避免混淆。

🧾 2.11 YAML 元数据（Front Matter）#

在文档最开头用 --- 包裹起来的区块，写文章的元信息：

1
---
2
title: "我的文章标题"
3
date: 2026-05-20
4
tags: [教程, Markdown]
5
categories: 技术
6
author: 火花花
7
---

Typora小技巧：输入 --- 回车自动弹出元数据编辑框。

💡 常见YAML字段：title(标题)、date(日期)、tags(标签)、categories(分类)、author(作者)、description(摘要)、published(是否发布)、pinned(是否置顶)、comment(是否开启评论)等。

📑 2.12 目录（Table of Contents，TOC）#

在任意位置写 [toc]，Typora会自动生成全文标题目录：

1
[toc]

💡 目录会根据你写的标题动态更新，增删改标题后目录自动同步，非常方便！

📈 2.13 图表（Diagrams）#

Typora支持 流程图、时序图、Mermaid图表。需要先在偏好设置中开启：

文件 → 偏好设置 → Markdown → 勾选「图表」

具体语法可以看我之前写的另一篇笔记 👉 📊 Mermaid 常用语法速查表

支持的图表类型：

• 流程图（Flowchart）
• 时序图（Sequence Diagram）
• 思维导图（Mindmap）
• 饼图（Pie Chart）
• 甘特图（Gantt Chart）
• ER关系图（Entity Relationship Diagram）

🗣️ 2.14 Callouts / 提示框（GitHub Style Alerts）#

Typora 1.8+ 版本支持 GitHub Style Alerts，需要在偏好设置中开启：

1
> [!NOTE] 这是注意事项
2
> 这里写注意内容
3

4
> [!TIP] 小贴士
5
> 这是一个有用的提示
6

7
> [!WARNING] 警告
8
> 这里要小心了！
9

10
> [!CAUTION] 危险
11
> 千万别这么做！
12

13
> [!IMPORTANT] 重要
14
> 这部分必须记住

效果：

[!NOTE] 这是注意事项 这里写注意内容

[!TIP] 小贴士 这是一个有用的提示

[!WARNING] 警告 这里要小心了！

[!CAUTION] 危险 千万别这么做！

[!IMPORTANT] 重要 这部分必须记住

🔗 3.1 链接（Links）#

1
[显示文字](链接地址 "可选标题")
2

3
[点击去Google](https://www.google.com "搜索")

1
[跳转到标题部分](#三行内元素span-elements)

1
这是[百度][baidu]和[谷歌][google]。
2

3
然后在文档末尾定义：
4
[baidu]: https://www.baidu.com "百度一下"
5
[google]: https://www.google.com "谷歌搜索"

1
[Google][] 是一个搜索引擎。
2

3
[Google]: https://www.google.com

🌐 3.2 URL / 网址#

用尖括号包裹URL会被自动转换：

1
<https://www.example.com>

效果： https://www.example.com

Typora还会自动识别标准网址（带www或https的），直接显示为可点击链接。

🖼️ 3.3 图片（Images）#

图片语法和链接很像，但前面加个 !：

1
![替代文字](图片路径 "可选标题")
2

3
![可爱猫咪](https://example.com/cat.jpg "一只小猫咪")

本地图片（放在同目录下）：

1
![博客截图](./blog-screenshot.png)

拖拽插入：直接把图片文件拖进Typora自动插入！

💡 YAML中设置根路径：在Front Matter中添加 typora-root-url: /User/xxx/Website/，然后图片路径就可以写相对路径了。

✨ 3.4 斜体（Emphasis）#

用 单 * 或 单 _ 包裹文字：

1
*这是斜体文字*
2
_这也是斜体_

效果： 这是斜体文字 / 这也是斜体

⚠️ 注意：GFM中下划线用在单词内部不会被识别（比如 do_this_and_that 中的下划线不会被当作斜体），所以推荐用 * 号来表示斜体。

💪 3.5 加粗（Strong）#

用 双 ** 或 双 __ 包裹：

1
**这段文字加粗**
2
__这段也加粗__

效果： 这段文字加粗 / 这段也加粗

💡 加粗 + 斜体：***三个星号*** → 三个星号效果

⌨️ 3.6 行内代码（Code）#

用反引号 `（键盘上1左边的键）包裹：

1
使用 `printf()` 函数可以输出内容。
2
`npm install` 命令安装依赖。

效果： 使用 printf() 函数可以输出内容。npm install 命令安装依赖。

💡 如果代码里本来就包含反引号，用双反引号包裹： print(“hello”)

3.7 删除线（Strikethrough）#

GFM特有语法，用双波浪线 ~~ 包裹：

1
~~这句话被删掉了~~
2
这是~~错误的~~正确的说法

效果： 这句话被删掉了 / 这是错误的正确的说法

3.8 下划线（Underlines）#

Markdown没有原生的下划线语法，需要用HTML标签：

1
<u>这段文字有下划线</u>

效果： 这段文字有下划线

😊 3.9 表情符号（Emoji）#

两种用法：

1
:smile:   → 😄
2
:heart:   → ❤️
3
:fire:    → 🔥
4
:rocket:  → 🚀
5
:100:     → 💯

或者直接输入Emoji（Mac按 Ctrl+Cmd+空格 打开表情面板，Windows按 Win+.）：

😄 ❤️ 🔥 🚀 ✅ ❌ ⭐ 🎉 💕😤👸

常用Emoji速查表：

∑ 3.10 行内数学公式（Inline Math）#

需要用 $ 包裹LaTeX代码（需在偏好设置中开启）：

1
爱因斯坦的质能方程：$E = mc^2$
2

3
极限公式：$\lim_{x \to \infty} \exp(-x) = 0$

效果： 爱因斯坦的质能方程：$E = mc^2$

极限公式：$\lim_{x \to \infty} \exp(-x) = 0$

💡 Typora中：输入 $ → 按 ESC 键 → 输入LaTeX代码 → 自动预览效果。

ₓ 3.11 下标（Subscript）#

用 ~ 包裹（需在偏好设置中开启）：

1
H~2~O（水的化学式）
2

3
X~long\ text~（长下标需要反斜杠转义空格）

效果： H2O / Xlong text

ˣ 3.12 上标（Superscript）#

用 ^ 包裹（需在偏好设置中开启）：

1
面积 = 长 × 宽（单位：m^2^）
2

3
X^3^ 表示X的三次方

效果： 面积 = 长 × 宽（单位：m²） / X³

🖍️ 3.13 高亮（Highlight）#

用 == 包裹（需在偏好设置中开启）：

1
这段话中==这部分被高亮了==，非常显眼！

效果： 这段话中==这部分被高亮了==，非常显眼！

🎨 字体颜色#

1
<span style="color:red">红色文字</span>
2
<span style="color:blue;font-size:20px">蓝色大号文字</span>

📺 嵌入内容#

1
<iframe src="https://codepen.io/..." width="100%" height="400"></iframe>

🎬 视频#

1
<video src="./demo.mp4" controls width="100%"></video>

其他常用HTML标签：

折叠展开示例：

1
<details>
2
<summary>点击展开查看详情</summary>
3

4
这里是被折叠的内容，点击上方按钮展开。
5

6
- 可以放列表
7
- 可以放代码
8
- 什么都能放
9

10
</details>

效果：

✅ 推荐写法#

📌 写Markdown的好习惯#

1. 标题别跳级 — H1 → H2 → H3，不要H2直接到H5
2. 列表统一缩进 — 2个空格或1个Tab
3. 代码块记得标注语言 — 自动高亮爽歪歪
4. 链接加标题属性 — 鼠标悬停时能看到说明
5. 图片加替代文字 — 图片加载失败时也能知道内容
6. 段落之间用空行 — 保证兼容所有Markdown解析器
7. YAML元数据必写 — 分类、标签方便检索

—— 本公主的学习笔记完成啦！学会了Markdown就能写出好看的文档和博客啦 😤💕

接下来可以学学 Mermaid 图表语法 👉 📊 Mermaid 常用语法速查表