B 分页方式

B-1 手动分页：---

我想实现什么： 在任意位置手动开始一张新幻灯片。

基本写法：

# 第一张幻灯片

内容在这里

---

# 第二张幻灯片

内容在这里

注意： YAML 头里的 --- 是用来包住设定的，不算分页。第一个分页符是 YAML 头结束后出现的 ---。

推荐写法： 在 --- 前后各留一个空行，避免渲染错误：

正文内容

---

# 下一页标题

常见问题：

  • --- 没有分页 → 检查 --- 前后是否有空行
  • 不小心把 YAML 头里的 --- 当成分页用了 → YAML 头的 --- 要成对出现，包住设定，不是分页

B-2 用 ## 自动分页

我想实现什么： 每遇到二级标题（##）就自动开始新的一页，不用手动写 ---。

基本写法：

---
marp: true
headingDivider: 2
---

## 第一节

内容

## 第二节

内容（自动分页）

推荐写法： 通常配合封面页一起用。封面页用 #（一级标题），不会被 headingDivider: 2 分页：

---
marp: true
headingDivider: 2
---

# 课程标题

## 副标题

---

## 第一章：引论

内容……

## 第二章：方法

内容……

常见问题：

  • 某一页不想被自动分页 → 在那个标题前面手动加 <!-- headingDivider: 0 -->（局部覆盖）
  • 想让 # 和 ## 都自动分页 → 用 headingDivider: [1, 2]

提示词：

我用了 headingDivider: 2，但有一个 ## 开头的内容不想分页（想和上一页合并）。请告诉我怎么处理，并给出示例。

B-3 用 ### 自动分页

我想实现什么： 让三级标题也自动分页。

基本写法：

---
marp: true
headingDivider: 3
---

设为 3 时，#、##、### 遇到都会自动分页。

如果只想让 ## 和 ### 分页，不想让 # 分页：

---
marp: true
headingDivider: [2, 3]
---

常见问题：

  • 内容层级太多、分页太碎 → 降回 headingDivider: 2，或者改用手动 ---
  • 想在某个 ### 前不分页 → 在那行前加 <!-- headingDivider: 0 -->

B-4 临时阻止某个标题触发分页

我想实现什么： 我用了 headingDivider: 2，但某个 ## 标题我不想让它分页（想和上面的内容在同一页）。

基本写法：

## 正常分页的标题

内容

<!-- headingDivider: 0 -->

## 这个标题不触发分页

这段内容会和上面在同一页。

在不想分页的 ## 标题前，加一行 <!-- headingDivider: 0 -->，它会覆盖全局设定，让这个标题不触发分页。

推荐写法： 如果只有个别页需要特殊处理，手动 --- 和 headingDivider 混用是最灵活的：

---
marp: true
headingDivider: 2
---

## 正常分页标题

内容

---

这是手动分页，不用标题

继续写内容……

## 下一个自动分页标题

提示词：

我用了 headingDivider: 2，有一张幻灯片需要在同一页里显示两个 ## 标题，请告诉我怎么实现并给出代码示例。