I 基本 Markdown 语法

Marp 使用 Markdown 来写幻灯片内容。Markdown 是一种极简的文本标记语言——你只需要在普通文字里加一些符号，就能表达标题、加粗、列表、代码等格式。

这个附录列出了在 Marp 幻灯片里最常用的 Markdown 语法，方便随时查阅。

标题

用 # 号表示标题，# 越多层级越低：

# 一级标题（幻灯片主标题）
## 二级标题（常用于分节标题）
### 三级标题（子标题）

在 Marp 里，# 和 ## 是最常用的两级，### 偶尔用于小节。

强调

**加粗文字**
*斜体文字*
~~删除线~~
`行内代码`

渲染效果：加粗文字，斜体文字，删除线，行内代码

列表

无序列表（用 - 或 *）：

- 要点一
- 要点二
  - 子要点（缩进两个空格）
  - 子要点
- 要点三

有序列表：

1. 第一步
2. 第二步
3. 第三步
Marp 里的列表建议

幻灯片里的列表不要超过 5 条，超过就考虑拆成两页。子要点也尽量少用，层级太深会让幻灯片显得很拥挤。

链接与图片

链接：

[链接文字](https://example.com)

图片：

![图片描述](./Figs/chart.png)

Marp 专用：图片尺寸控制

![width:400px](./Figs/chart.png)
![width:60%](./Figs/chart.png)
![height:300px](./Figs/chart.png)

代码

行内代码（用反引号包住）：

用 `marp: true` 启用 Marp。

代码块（用三个反引号，注明语言）：

```python
import pandas as pd
df = pd.read_csv("data.csv")
```

常用语言标识：python、r、stata、bash、sql、yaml、markdown

引用

> 这是一段引用文字。
> 可以跨多行。

渲染后会显示为带左侧竖线的缩进段落。

分隔线

---

在 Marp 里，--- 用于分页（见第一章）。在普通 Markdown 里，它表示水平分隔线。

表格

| 列一 | 列二 | 列三 |
|------|------|------|
| 内容 | 内容 | 内容 |
| 内容 | 内容 | 内容 |

对齐控制：

| 左对齐 | 居中 | 右对齐 |
|:-------|:----:|-------:|
| 内容   |  内容 |   内容 |

数学公式

Marp 支持 LaTeX 数学公式（需在 YAML 头加 math: katex）：

行内公式：

质能方程为 $E = mc^2$。

独立公式块：

$$
\hat{\beta} = (X'X)^{-1}X'y
$$

HTML 标签

Marp 支持在 Markdown 里直接写 HTML，常用于：

<!-- 图片尺寸（最稳妥的写法） -->
<img src="./Figs/chart.png" style="width:60%;">

<!-- 文字颜色 -->
<span style="color:#1565c0;">蓝色文字</span>

<!-- 小字注释 -->
<small>这是小字</small>

扩展阅读

如果你想系统学习 Markdown，以下资源值得参考：

不需要全部记住

实际写 Marp 幻灯片时，你用到最多的只有：标题（# ##）、加粗（**）、列表（-）、代码块（```）和图片（![]() 或 <img>）。其他语法用到的时候来这里查就好。