Marp Slides Creator

---
name: marp-slides-creator
description: '专业Marp演示文稿制作助手。支持完整工作流程：工作空间初始化、内容分析、slides制作、多维度审阅、中文语言规范审阅（中文演示文稿）、PNG转换检查、终稿确定。所有产出物集中管理在项目工作文件夹中。当用户提到"制作slides"、"做PPT"、"演示文稿"、"Marp"、"幻灯片"、"presentation"等关键词时自动启用。Professional Marp presentation assistant with complete workflow: workspace initialization, content analysis, slide creation, multi-dimensional review, Chinese language review (for Chinese presentations), PNG conversion check, and finalization. All outputs organized in project workspace.'
allowed-tools: Read, Write, Edit, Bash, Task, Glob
---

# Marp Slides 制作助手

## 技能概述

本技能提供系统性多阶段Marp演示文稿制作流程，从工作空间初始化到终稿输出。对于中文演示文稿，额外包含中文语言规范审阅阶段。所有分析报告、初稿、审阅文档、PNG导出和终稿统一保存在项目工作文件夹中，便于管理和追溯。

**支持多种主题风格**：内置 14 款精选主题，涵盖学术、商务、创意等场景。详见 `themes/README.md`。

## 核心原则

### Slides设计原则

| 原则 | 说明 | 要点 |
|------|------|------|
| 一页一点 | 每页只讲一个核心观点 | 避免信息过载 |
| 视觉层次 | 标题→要点→细节 | 使用粗体、列表、引用区分 |
| 留白充足 | 内容不超过页面60% | 给观众呼吸空间 |
| 文字精简 | 每页文字不超过8行 | 关键词优于完整句子 |

### 内容密度控制

- **标题页**：主标题 + 副标题 + 作者信息
- **内容页**：标题 + 3-5个要点（每点1-2行）
- **对比页**：两栏对比，每栏不超过4点
- **总结页**：3-5个核心要点

## 七阶段工作流程

严格按照以下流程执行，每阶段结束后询问用户确认：

### 阶段零：工作空间初始化与主题选择（预处理）

**触发**：用户请求制作slides时立即执行

**执行步骤**：

1. **确定项目名称**：
   - 根据用户提供的主题/文件名确定项目名称
   - 使用简短的英文或拼音命名，用连字符连接
   - 示例：`academic-writing`、`ai-introduction`、`product-launch`

2. **创建工作文件夹结构**：
   ```bash
   # 创建主工作文件夹和子目录
   mkdir -p slides_[项目名]/{01_analysis,02_drafts,03_reviews,04_exports,05_final}
   ```

3. **文件夹结构说明**：

   ```text
   slides_[项目名]/
   ├── 01_analysis/           # 阶段一：分析报告
   │   ├── content-analysis.md   # 内容分析报告
   │   └── outline.md            # Slides大纲
   ├── 02_drafts/             # 阶段二：初稿
   │   └── presentation.md       # Slides初稿
   ├── 03_reviews/            # 阶段三：审阅报告
   │   ├── content-review.md     # 内容审阅
   │   ├── format-review.md      # 格式审阅
   │   ├── density-review.md     # 密度审阅
   │   ├── visual-review.md      # 视觉审阅
   │   ├── chinese-review.md     # 中文规范审阅（仅中文）
   │   └── summary.md            # 综合审阅报告
   ├── 04_exports/            # 阶段四：PNG/HTML导出
   │   ├── slide_001.png
   │   ├── slide_002.png
   │   └── slides.html
   ├── 05_final/              # 阶段五：终稿
   │   ├── presentation.md       # 最终Markdown
   │   ├── slides.html           # HTML版本
   │   └── slides.pdf            # PDF版本（可选）
   └── README.md              # 项目说明文件
   ```

4. **主题选择**：

   使用 AskUserQuestion 工具让用户选择主题风格：

   ```
   questions:
     - question: "请选择演示文稿的主题风格"
       header: "主题风格"
       multiSelect: false
       options:
         - label: "academic (学术风格)"
           description: "适合学术报告、论文答辩，maroon红色标题栏"
         - label: "beam (Beamer风格)"
           description: "仿LaTeX Beamer，适合学术演讲、技术研讨"
         - label: "jobs (乔布斯风格)"
           description: "Apple发布会风格，适合产品发布、商业演示"
         - label: "graph_paper (方格纸风格)"
           description: "技术分享、教学演示，手写笔记感"
   ```

   **可用主题列表**（按场景分类）：

   | 场景 | 主题选项 |
   |------|----------|
   | 学术答辩 | academic, beam, zju |
   | 技术分享 | graph_paper, beam, turing |
   | 产品发布 | jobs, gradient |
   | 企业汇报 | companyLightBlue, companySZ |
   | 教学演示 | simple, graph_paper, academic |
   | 创意展示 | gradient, jobs, socrates |

   **主题文件位置**：`themes/` 目录下所有 `.css` 文件

5. **创建README.md**：
   ```markdown
   # [项目名] Slides

   ## 项目信息
   - 创建时间：[日期]
   - 输入材料：[原始文件名]
   - 主题：[主题描述]
   - **使用主题**：[选择的主题名称，如 academic/beam/jobs 等]

   ## 文件夹说明
   - `01_analysis/` - 内容分析和大纲
   - `02_drafts/` - Slides初稿
   - `03_reviews/` - 审阅报告
   - `04_exports/` - PNG和HTML导出
   - `05_final/` - 最终版本

   ## 制作进度
   - [ ] 阶段零：工作空间初始化
   - [ ] 阶段一：内容分析
   - [ ] 阶段二：初稿制作
   - [ ] 阶段三：多维度审阅
   - [ ] 阶段三B：中文语言规范审阅（仅中文演示文稿）
   - [ ] 阶段四：PNG转换检查
   - [ ] 阶段五：问题修复与终稿
   ```

**输出**：工作文件夹路径、选择的主题名称，告知用户所有产出物将保存在此文件夹中

---

### 阶段一：内容分析与消化

**触发**：工作空间创建完成后，用户提供输入文件（PDF、论文、文档、笔记等）

**执行步骤**：

1. **初步阅读**：使用 Read 工具读取输入文件，了解整体结构
2. **深度分析**：
   - 提取核心论点和关键信息
   - 识别逻辑结构（问题-方案-结论 / 现状-分析-建议 等）
   - 标记重要数据、引用、案例
3. **内容分类**：
   - 核心观点（必须包含）
   - 支撑证据（选择性包含）
   - 背景信息（简化或省略）
4. **大纲生成**：
   - 确定slides数量（建议10-20页）
   - 规划每页主题和内容密度
   - 设计叙事流程

**文件保存**：
- 内容分析报告：`slides_[项目名]/01_analysis/content-analysis.md`
- Slides大纲：`slides_[项目名]/01_analysis/outline.md`

**输出模板**：

`01_analysis/content-analysis.md`:
```markdown
## 内容分析报告

### 文档概述
- 主题：[主题]
- 类型：[论文/报告/教程/...]
- 核心论点：[1-2句话]

### 关键内容提取
1. [关键点1]
2. [关键点2]
...
```

`01_analysis/outline.md`:
```markdown
## Slides大纲（预计X页）

1. 标题页
2. [内容页标题]
3. ...
```

### 阶段二：Slides初稿制作

**触发**：用户确认内容分析和大纲

**执行步骤**：

1. **读取模板**：使用 Read 工具读取 `marp-template.md`
2. **应用主题**：
   - 在 YAML frontmatter 中设置用户选择的主题：
     ```yaml
     ---
     marp: true
     theme: [用户选择的主题名]
     ---
     ```
   - 不同主题可能支持特殊的 class，参考 `themes/README.md`

3. **主题适配（自动调整）**：

   不同主题对标题格式有不同要求，制作 slides 时必须根据主题自动调整：

   | 主题 | 内容页标题格式 | 说明 |
   |------|----------------|------|
   | **beam** | `#` (h1) | h1 显示在顶部蓝色条中 |
   | **academic** | `#` (h1) | h1 用于页面标题 |
   | **jobs** | `#` (h1) | h1 有特殊下划线样式 |
   | graph_paper | `##` (h2) | 标准 h2 标题 |
   | simple | `##` (h2) | 标准 h2 标题 |
   | 其他主题 | `##` (h2) | 默认使用 h2 |

   **beam 主题特殊处理**：
   - 每页第一个 `#` (h1) 会自动显示在顶部蓝色装饰条中
   - 标题页使用 `<!-- _class: title -->` 指令
   - 内容页直接使用 `#` 标题（不是 `##`）
   - 示例：
     ```markdown
     ---
     # 页面标题在蓝色条中

     正文内容...
     ```

   **academic/jobs 主题特殊处理**：
   - 同样使用 `#` (h1) 作为页面标题
   - 支持 `class: lead` 用于特殊页面

4. **必须包含居中样式**：frontmatter 的 `style` 中必须包含以下 CSS，否则图片和表格会左对齐：
     ```css
     /* 图片居中 */
     img {
       display: block !important;
       margin: 0 auto !important;
     }
     /* 表格居中（覆盖主题的 width:100% 和 display:block） */
     section table {
       display: table !important;
       width: auto !important;
       margin-left: auto !important;
       margin-right: auto !important;
     }
     ```
     > **原因**：Marp 基础 CSS 设置 `section table { display: block; width: max-content }`，多数自定义主题又设置 `table { width: 100% }`，两者都会导致表格无法居中。必须用 `!important` 同时覆盖 `display`、`width` 和 `margin` 三个属性才能生效。`marp-template.md` 已包含这些样式。

5. **修改Header/Footer**：根据演讲主题调整
6. **逐页制作**：
   - 遵循模板中的页面类型和格式
   - 每页严格控制内容量
   - 使用适当的Markdown格式（粗体、引用、列表）

**页面类型选择**（参考 `references/slide-types.md`）：

- 标题页：开场
- 目录页：内容预告
- 单点页：核心观点展示
- 列表页：多要点展示
- 对比页：两种观点/方案对比
- 引用页：重要引用展示
- 分隔页：章节过渡
- 总结页：要点回顾

**文件保存**：

- 保存初稿：`slides_[项目名]/02_drafts/presentation.md`
- 更新README.md中的进度状态

### 阶段三：多维度并行审阅

**触发**：初稿完成后自动进入

**执行方式**：使用 Task 工具并行派遣4个专业agent，每个负责一个审阅维度

**并行Agent部署**：

```
在单个消息中同时发起4个Task调用，设置 run_in_background=true：
```

#### Agent 1：内容审阅专家

```
Task 工具参数：
- subagent_type: "general-purpose"
- run_in_background: true
- prompt:

你是一个内容审阅专家。请对比审阅slides内容。

## 输入材料

### 用户原始输入文件
[插入用户提供的原始文件内容]

### 用户的具体要求
[插入用户提出的要求和偏好]

### 制作的Slides初稿
[插入presentation.md内容]

## 审阅任务

1. **完整性检查**：
   - 原始材料中的核心论点是否都已体现？
   - 是否有重要信息被遗漏？
   - 列出遗漏的关键内容

2. **准确性检查**：
   - slides内容是否准确反映原始材料？
   - 是否有曲解或过度简化？
   - 数据和事实是否正确转述？

3. **用户要求符合度**：
   - 是否满足用户提出的具体要求？
   - 风格和重点是否符合用户期望？
   - 列出未满足的要求

4. **逻辑流检查**：
   - 叙事顺序是否合理？
   - 各页之间过渡是否自然？
   - 整体结构是否清晰？

## 输出格式

### 内容审阅报告

#### 完整性评估
- 评分：[A/B/C/D]
- 遗漏内容：[列表]

#### 准确性评估
- 评分：[A/B/C/D]
- 问题页面：[页码和问题描述]

#### 用户要求符合度
- 评分：[A/B/C/D]
- 未满足要求：[列表]

#### 逻辑流评估
- 评分：[A/B/C/D]
- 建议调整：[具体建议]

#### 需修改页面清单
| 页码 | 问题类型 | 问题描述 | 修改建议 |
|------|----------|----------|----------|
| ... | ... | ... | ... |
```

#### Agent 2：格式审阅专家

```
Task 工具参数：
- subagent_type: "general-purpose"
- run_in_background: true
- prompt:

你是一个Marp格式审阅专家。请检查slides的格式规范性。

## Slides内容
[插入presentation.md内容]

## 审阅任务

1. **YAML Frontmatter检查**：
   - marp: true 是否存在？
   - theme 是否正确设置？
   - header/footer 是否配置？
   - style 块语法是否正确？

2. **分页符检查**：
   - `---` 分页符是否正确使用？
   - 是否有多余或缺失的分页符？
   - 分页符前后是否有空行？

3. **Markdown语法检查**：
   - 标题层级是否正确（#, ##, ###）？
   - 列表格式是否统一？
   - 粗体、斜体语法是否正确？
   - 引用块语法是否正确？
   - 代码块是否正确闭合？

4. **缩进和空行检查**：
   - 缩进是否一致？
   - 空行使用是否规范？
   - 是否有多余的空白字符？

## 输出格式

### 格式审阅报告

#### 语法正确性
- 评分：[A/B/C/D]
- 语法错误：[列表，含行号]

#### 格式一致性
- 评分：[A/B/C/D]
- 不一致处：[列表]

#### 需修正项
| 行号 | 问题类型 | 原内容 | 建议修正 |
|------|----------|--------|----------|
| ... | ... | ... | ... |
```

#### Agent 3：密度审阅专家

```
Task 工具参数：
- subagent_type: "general-purpose"
- run_in_background: true
- prompt:

你是一个slides内容密度审阅专家。请逐页检查内容密度。

## Slides内容
[插入presentation.md内容]

## 密度标准

| 指标 | 安全值 | 警告值 | 危险值 |
|------|--------|--------|--------|
| 每页文字行数 | ≤6行 | 7-8行 | >8行 |
| 每行字符数 | ≤35字符 | 36-45字符 | >45字符 |
| 列表项数量 | ≤5项 | 6项 | >6项 |
| 嵌套列表深度 | 1层 | 2层 | >2层 |
| 段落长度 | ≤2行 | 3行 | >3行 |

## 审阅任务

逐页分析：
1. 统计每页的文字行数
2. 检查最长行的字符数
3. 统计列表项数量
4. 检查是否有过长段落
5. 评估整体视觉密度

## 输出格式

### 密度审阅报告

#### 逐页密度分析

| 页码 | 行数 | 最长行 | 列表项 | 密度评级 | 状态 |
|------|------|--------|--------|----------|------|
| 1 | X | X字符 | X项 | 低/中/高 | ✓/⚠/✗ |
| 2 | ... | ... | ... | ... | ... |

#### 高密度页面（需处理）
- 第X页：[问题描述]，建议：[拆分/精简/重组]
- ...

#### 拆分建议
对于需要拆分的页面，提供具体拆分方案：
- 第X页 → 拆分为 X-1 和 X-2
  - X-1 内容：...
  - X-2 内容：...
```

#### Agent 4：视觉审阅专家

```
Task 工具参数：
- subagent_type: "general-purpose"
- run_in_background: true
- prompt:

你是一个slides视觉设计审阅专家。请检查视觉层次和设计规范。

## Slides内容
[插入presentation.md内容]

## 审阅任务

1. **标题层次检查**：
   - 每页是否有清晰的标题？
   - 标题层级使用是否合理？
   - h1用于分隔页，h2用于内容页？

2. **强调元素检查**：
   - 粗体是否用于关键词/要点？
   - 引用块是否用于重要引语？
   - 强调是否过度（全篇都是粗体）？

3. **视觉焦点检查**：
   - 每页是否有明确的视觉焦点？
   - 信息层次是否清晰？
   - 是否有页面过于平淡或过于杂乱？

4. **一致性检查**：
   - 相似内容的页面格式是否统一？
   - 列表符号是否一致？
   - 整体风格是否协调？

## 输出格式

### 视觉审阅报告

#### 标题层次
- 评分：[A/B/C/D]
- 问题页面：[列表]

#### 强调使用
- 评分：[A/B/C/D]
- 改进建议：[列表]

#### 视觉焦点
- 评分：[A/B/C/D]
- 需优化页面：[列表]

#### 一致性
- 评分：[A/B/C/D]
- 不一致处：[列表]

#### 需修改页面清单
| 页码 | 问题 | 建议 |
|------|------|------|
| ... | ... | ... |
```

**汇总审阅结果**：

使用 TaskOutput 工具收集4个agent的报告，整合为统一的审阅报告。

**文件保存**：

- 内容审阅报告：`slides_[项目名]/03_reviews/content-review.md`
- 格式审阅报告：`slides_[项目名]/03_reviews/format-review.md`
- 密度审阅报告：`slides_[项目名]/03_reviews/density-review.md`
- 视觉审阅报告：`slides_[项目名]/03_reviews/visual-review.md`
- 综合审阅报告：`slides_[项目名]/03_reviews/summary.md`

**综合审阅报告模板** (`03_reviews/summary.md`):

```markdown
## 综合审阅报告

### 各维度评分

| 维度 | 评分 | 主要问题 |
|------|------|----------|
| 内容 | [A-D] | [概述] |
| 格式 | [A-D] | [概述] |
| 密度 | [A-D] | [概述] |
| 视觉 | [A-D] | [概述] |

### 需修改页面汇总

[按页码整合所有agent的修改建议]

### 优先处理项

1. [最重要的问题]
2. [次重要的问题]
...
```

**输出**：综合审阅报告，按优先级排列的修改清单

### 阶段三B：中文语言规范审阅（仅中文演示文稿）

**触发**：多维度审阅完成后，如果是中文演示文稿则执行此阶段

**执行方式**：使用 Task 工具派遣 subagent 执行

**Subagent 调用指令**：

```text
使用 Task 工具，设置 subagent_type="general-purpose"，prompt 内容如下：

你是一个中文语言规范专家。请对以下Marp Slides进行逐页审阅，确保符合中文书写规范和演示文稿语言习惯：

[插入 slides_[项目名]/02_drafts/presentation.md 的内容]

审阅要求：

1. **标点符号检查**：
   - 必须使用中文标点：。，？！：；“” ‘’（）……——
   - 禁止使用英文标点：. , ? ! : ; ""'' () ... --
   - 列表项末尾可省略句号
   - 标题末尾不加标点

2. **引号使用规范**（重要）：
   - 原则：Slides中能不用引号就不用，让文字更简洁
   - 删除不必要的引号，例如：
     - ✗ 这就是所谓的"核心概念" → ✓ 这就是核心概念
     - ✗ AI的"智能"表现 → ✓ AI的智能表现
   - 仅在以下情况保留引号：
     - 直接引语（如：他说："……"）
     - 表示反讽或特殊含义
     - 专有名词首次出现且需要解释

3. **语言习惯检查**：
   - 避免欧化句式（如"被"字句滥用）
   - 避免翻译腔
   - 删除冗余表达（Slides需要极简文字）
   - 使用自然的中文表达顺序
   - 避免长句，每个要点保持简短

4. **中英文混排规范**：
   - 中文与英文/数字之间加空格（如：Claude Code 是工具）
   - 全角标点与英文之间不加空格
   - 技术术语保持一致（如：API、SDK 等全文统一）

5. **Slides特有检查**：
   - 标题是否简洁有力
   - 要点是否用词精准
   - 是否避免了口语化表达
   - 专业术语是否一致

输出格式：

## 中文规范审阅报告

### 标点符号修正
| 页码 | 原文 | 修正后 |
|------|------|--------|
| ... | ... | ... |

### 引号精简
| 页码 | 修改内容 |
|------|----------|
| ... | 删除"xxx"的引号 |

### 表达优化
| 页码 | 原表达 | 优化后 |
|------|--------|--------|
| ... | ... | ... |

### 中英文混排修正
| 页码 | 原文 | 修正后 |
|------|------|--------|
| ... | ... | ... |

### 修正后的完整Slides
[输出完成所有修正的Slides内容]
```

**文件保存**：

- 中文规范审阅报告：`slides_[项目名]/03_reviews/chinese-review.md`

**后续处理**：

- 收到 subagent 返回的审阅报告后，使用 Edit 工具将修正应用到 `slides_[项目名]/02_drafts/presentation.md`
- 将修正后的Slides传递给阶段四

---

### 阶段四：PNG转换与并行检查

**触发**：审阅修改完成后

**执行步骤**：

1. **转换为PNG**：

   ```bash
   # 从02_drafts读取初稿，导出到04_exports
   marp slides_[项目名]/02_drafts/presentation.md -o slides_[项目名]/04_exports/slides.html --html
   marp slides_[项目名]/02_drafts/presentation.md --images png -o slides_[项目名]/04_exports/
   ```

2. **并行部署Agents检查**：
   使用 Task 工具并行派遣多个 subagent，每个检查一组页面：

   ```text
   使用 Task 工具，设置 subagent_type="general-purpose"，run_in_background=true

   派遣多个agents（根据总页数，每个agent检查3-5页）：

   Agent 1: 检查第1-5页
   Agent 2: 检查第6-10页
   Agent 3: 检查第11-15页
   ...

   每个Agent的prompt：

   你是一个slides视觉质量检查专家。请检查以下PNG图片：

   [使用Read工具读取 slides_[项目名]/04_exports/ 中对应的PNG文件]

   检查要点：
   1. 文字是否超出页面边界？
   2. 内容是否过于拥挤？
   3. 文字是否过小难以阅读？
   4. 布局是否平衡？
   5. 是否有明显的格式问题？

   输出格式：
   ## 页面检查报告

   ### 第X页
   - 状态：通过 / 需修改
   - 问题：[问题描述]
   - 建议：[修改建议，如"拆分为两页"或"精简第3个要点"]
   ```

3. **汇总检查结果**：使用 TaskOutput 工具收集所有agent的报告

**文件保存位置**：

- HTML预览：`slides_[项目名]/04_exports/slides.html`
- PNG图片：`slides_[项目名]/04_exports/presentation.001.png`, `presentation.002.png`, ...

### 阶段五：问题修复与终稿确定

**触发**：收到所有页面检查报告

**执行步骤**：

1. **问题分类**：
   - **溢出问题**：文字超出页面 → 拆分页面或精简内容
   - **密度问题**：内容过多 → 删减或重组
   - **格式问题**：排版错误 → 修正Markdown
   - **可读性问题**：字太小/太密 → 调整层次

2. **逐一修复**：
   使用 Edit 工具修改 `slides_[项目名]/02_drafts/presentation.md`，针对每个问题：

   - **拆页策略**：将一页拆为"概述页"+"详情页"
   - **精简策略**：删除次要信息，保留核心
   - **重组策略**：调整信息层次，使用更合适的页面类型

3. **重新验证**：
   - 再次转换为PNG到 `04_exports/`
   - 快速检查修改后的页面
   - 确认问题已解决

4. **生成终稿**：
   将修复后的文件复制到 `05_final/` 并导出最终版本：

   ```bash
   # 复制终稿Markdown
   cp slides_[项目名]/02_drafts/presentation.md slides_[项目名]/05_final/presentation.md

   # 导出最终HTML（带自定义主题）
   npx @marp-team/marp-cli slides_[项目名]/05_final/presentation.md -o slides_[项目名]/05_final/slides.html --html --theme-set ./themes/
   ```

5. **导出多格式版本**：

   使用 marp-cli 导出 PDF 和 PowerPoint 格式：

   ```bash
   # 导出 PDF 版本
   npx @marp-team/marp-cli slides_[项目名]/05_final/presentation.md -o slides_[项目名]/05_final/slides.pdf --theme-set ./themes/ --allow-local-files

   # 导出可编辑的 PowerPoint (PPTX) 版本
   npx @marp-team/marp-cli slides_[项目名]/05_final/presentation.md -o slides_[项目名]/05_final/slides.pptx --pptx-editable --theme-set ./themes/ --allow-local-files
   ```

   **导出说明**：
   - `--allow-local-files`：允许加载本地图片和资源
   - `--theme-set ./themes/`：加载自定义主题目录
   - `--pptx-editable`：导出可编辑的 PPTX（需要系统安装 LibreOffice）
   - PDF 适合打印和分发
   - PPTX 适合在 PowerPoint/Keynote 中进一步编辑

   **注意**：`--pptx-editable` 需要系统安装 LibreOffice Impress。如未安装，可使用 Homebrew 安装：
   ```bash
   brew install --cask libreoffice
   ```

6. **更新项目README**：
   更新 `slides_[项目名]/README.md` 中的进度，标记所有阶段为完成。

**终稿文件位置**：

- 最终Markdown：`slides_[项目名]/05_final/presentation.md`
- HTML版本：`slides_[项目名]/05_final/slides.html`
- PDF版本：`slides_[项目名]/05_final/slides.pdf`
- PowerPoint版本：`slides_[项目名]/05_final/slides.pptx`

**输出**：终稿文件路径（包含 HTML、PDF、PPTX 三种格式）和制作摘要

## 常见问题处理

### 文字溢出

**原因**：单页内容过多

**解决方案**：
1. **拆分法**：将内容拆分为多页
   ```markdown
   ## 原始页面：五个要点

   拆分为：

   ## 要点概览（1/2）
   1. 要点一
   2. 要点二
   3. 要点三

   ---

   ## 要点概览（2/2）
   4. 要点四
   5. 要点五
   ```

2. **精简法**：删除次要信息
3. **层次法**：使用子列表缩短主列表

### 代码块过长

**解决方案**：
- 只展示关键代码片段
- 使用伪代码替代完整代码
- 分多页展示，每页一个逻辑单元

### 表格过大

**解决方案**：
- 拆分为多个小表格
- 转换为列表形式
- 只展示关键数据行

## 模板使用说明

模板文件 `marp-template.md` 包含：
- graph_paper主题配置
- 中文字体支持
- 蓝色引用块样式
- 多种页面类型示例

**修改Header/Footer**：
```yaml
header: '你的课程/演讲标题'
footer: "讲座标题 | 机构名称"
```

## 资源引用

### 参考文件
- **`marp-template.md`** - Marp模板文件
- **`references/slide-types.md`** - 页面类型详解
- **`references/review-checklist.md`** - 审阅检查清单
- **`themes/README.md`** - 主题说明文档
- **`themes/*.css`** - 14款精选主题文件

## Marp-CLI 命令参考

```bash
# 预览初稿（启动本地服务器，加载自定义主题）
npx @marp-team/marp-cli -s slides_[项目名]/02_drafts/presentation.md --theme-set ./themes/

# 导出初稿到04_exports（使用自定义主题）
npx @marp-team/marp-cli slides_[项目名]/02_drafts/presentation.md -o slides_[项目名]/04_exports/slides.html --html --theme-set ./themes/
npx @marp-team/marp-cli slides_[项目名]/02_drafts/presentation.md --images png -o slides_[项目名]/04_exports/ --theme-set ./themes/

# 导出终稿到05_final（HTML）
npx @marp-team/marp-cli slides_[项目名]/05_final/presentation.md -o slides_[项目名]/05_final/slides.html --html --theme-set ./themes/

# 导出终稿 PDF 版本
npx @marp-team/marp-cli slides_[项目名]/05_final/presentation.md -o slides_[项目名]/05_final/slides.pdf --theme-set ./themes/ --allow-local-files

# 导出终稿可编辑 PowerPoint (PPTX) 版本
npx @marp-team/marp-cli slides_[项目名]/05_final/presentation.md -o slides_[项目名]/05_final/slides.pptx --pptx-editable --theme-set ./themes/ --allow-local-files
```

**参数说明**：

| 参数 | 说明 |
|------|------|
| `--theme-set ./themes/` | 加载本地 themes 文件夹中的所有主题 |
| `--allow-local-files` | 允许加载本地图片和资源（PDF/PPTX 导出必需） |
| `--pptx-editable` | 导出可编辑的 PPTX（需要 LibreOffice） |
| `--html` | 启用 HTML 标签支持 |
| `-s` | 启动预览服务器 |
| `--images png` | 导出为 PNG 图片序列 |

**导出格式说明**：

| 格式 | 用途 | 文件扩展名 |
|------|------|-----------|
| HTML | 网页展示、在线分享 | `.html` |
| PDF | 打印、正式分发 | `.pdf` |
| PPTX | PowerPoint/Keynote 编辑 | `.pptx` |
| PNG | 图片预览、质量检查 | `.001.png`, `.002.png`, ... |

## 交互规范

1. 每阶段结束后询问用户是否继续
2. 内容分析后让用户确认大纲再继续
3. 检查发现问题时，说明问题和建议的修复方案
4. 提供选择时给出推荐选项和理由

## 禁止事项

- 不跳过内容分析直接制作slides
- 不在单页放置过多内容
- 不使用过小的字体或过密的排版
- 不忽略PNG检查结果
- 不输出未经验证的终稿