6 八个模板

与其从空白文件开始，不如直接复制一个模板、改改内容就能用。

Github 仓库的【template】文件夹里提供了 8 个由浅入深的模板，覆盖了从入门练习到学术报告的常见场景。找到最接近你需求的那个，复制过去，改文字，就完成了。

查看和下载模板文件

方法 1： 下载单个模板

以 marp01_simple.md 为例，你可以通过如下步骤查看或下载该模板文件：

查看：点击 raw → 全选→ 复制 → 粘贴到新建的 .md 文档中。
下载：访问 template/marp01_simple.md 页面 → 点击右上角的下载按钮

方法 2： 手动批量下载

访问 Github 仓库：marp-book，点击绿色 <>Code 按钮，选择 Download ZIP 下载本仓库。
解压缩后，在 VS Code 编辑器中，依次点击 File → Open folder (Ctrl+K / Ctrl+O)，打开 [marp-book] 文件夹，即可在 [template] 子文件夹中查看模板文件。

方法 2： 使用 github desktop 下载

如果你熟悉 git，可以在 VScode 终端使用 git 命令 Fork 或 clone 本仓库。对于多数人来说，推荐使用 GitHub Desktop，详情参见：GitHub Desktop 使用方法介绍：可视化 Git 管理的效率工具。

模板只是起点

所有模板都可以用 AI 继续修改和扩展。遇到想要的效果，把模板代码贴给 AI，描述需求，AI 会帮你调整。具体提示词见第五章。

6.1 模板一览

文件名	难度	适合场景
`marp01_simple.md`	⭐ 入门	第一次练习，验证环境
`marp02_basic.md`	⭐⭐ 基础	日常课程讲义、组会汇报
`marp03_styled.md`	⭐⭐ 基础	需要公式、提示框、小字注释
`marp04_twocol.md`	⭐⭐⭐ 进阶	代码演示、双栏对比
`marp05_paper.md`	⭐⭐⭐⭐ 进阶	学术论文汇报、会议展示
`marp06_data.md`	⭐⭐⭐ 进阶	数据分析报告、图表展示
`marp07_teaching.md`	⭐⭐⭐ 进阶	课程讲授、逐步推导
`marp08_report.md`	⭐⭐⭐ 进阶	政策报告、工作汇报

6.2 快速选择指南

我是第一次用 Marp
└── marp01_simple ← 先跑起来

我要做一份普通课程讲义
└── marp02_basic ← 够用了

我需要公式或彩色提示框
└── marp03_styled

我要展示代码和运行结果
└── marp04_twocol

我要做学术报告或论文汇报
└── marp05_paper

我要做数据分析报告（图表、KPI、回归结果）
└── marp06_data

我要做课程教学（板书、逐步推导、对比框）
└── marp07_teaching

我要做政策报告或工作汇报
└── marp08_report

6.3 marp01_simple：基本示例

难度： ⭐
适合： 第一次使用 Marp，验证环境是否安装正确

这是一份只有三张幻灯片的基本文件，没有任何额外设定，只用了 marp: true 启用 Marp，以及 --- 手动分页。

包含的内容：

一级标题页（#）
带要点列表和本地图片的页面
一张空白页

图片路径说明

marp01_simple.md 里引用了 ./Figs/MarpLogo.png。你需要在同一文件夹下建 Figs/ 子文件夹并放入图片，或者直接把图片行删掉。

6.4 marp02_basic：基础讲义模板

难度： ⭐⭐
适合： 日常课程讲义、组会汇报、部门分享

在 marp01 的基础上，加入了最常用的几个全局设定：主题、页码、页眉页脚，以及一个不显示页眉页脚的封面页。

包含的内容：

YAML 头：theme、size、paginate、header、footer
封面页（无页眉、页脚、页码）
3 张示例内容页

使用步骤：

复制文件，修改 YAML 头里的 header 和 footer 内容
把封面页的标题和姓名改掉
按需增减内容页，用 --- 分页

可以直接修改的地方：

header: "课程名称"      ← 改成你的课程/项目名
footer: "姓名  ·  日期" ← 改成你的信息

6.5 marp03_styled：带样式的讲义模板

难度： ⭐⭐
适合： 需要数学公式、彩色提示框、底部注释的讲义

在 marp02 的基础上，增加了一个 <style> 块，定义了字号、标题颜色、提示框 class 和小字注释 class。

新增功能：

自定义字号（正文 22px，h1/h2 带颜色）
4 种提示框：.box-note（蓝）、.box-warn（黄）、.box-tip（绿）
底部注释 class：.note
KaTeX 数学公式支持

使用提示框：

<div class="box-note">

💡 **提示：** 文字内容写在这里。

</div>

使用底部注释：

<div class="note">注：数据来源于……</div>

关于 <div> 和空行

<div> 标签和里面的 Markdown 内容之间必须留空行，否则 Markdown 不会被正确解析（会显示成原始文字）。

6.6 marp04_twocol：双栏与代码展示模板

难度： ⭐⭐⭐
适合： 代码教学、方法对比、数据可视化展示

在 marp03 的基础上，重点增加了双栏布局相关的 CSS class，并提供了三种典型页面的示例：左文右图、左代码右结果、三栏方法对比。

新增 CSS class：

Class	用途
`.cols`	等宽双栏（50:50）
`.cols-6040`	左宽右窄（60:40）
`.cols-4060`	左窄右宽（40:60）

左代码右结果的写法：

<div class="cols">
<div>

```python
# 左边写代码
```

</div>
<div>

```text
# 右边写输出
```

</div>
</div>

三栏对比： 模板里提供了一个带卡片样式的三栏页面（OLS / IV / DID 对比），可以直接修改内容复用。

图片尺寸

双栏里的图片建议用 HTML 写法，确保宽度 100% 填满栏位：

<img src="./Figs/chart.png" style="width:100%;">

6.7 marp05_paper：学术报告模板

难度： ⭐⭐⭐⭐
适合： 论文汇报、学术会议展示、课题答辩

这是功能最完整的模板，内置了深蓝渐变封面、节标题过渡页、双栏数据表格、回归结果展示等学术报告常用版式。

特色功能：

① 封面页（深蓝渐变背景）

<!-- _class: cover -->
<!-- _paginate: false -->

# 论文标题
## A Subtitle in English
作者 · 单位 · 年份

② 节标题过渡页（浅蓝背景，居中大字）

<!-- _class: section-title -->
<!-- _paginate: false -->

## 01 · 引言

③ 回归结果页（左表右文，含发现框和注释）

模板里已经写好了一个完整的”基准回归结果”页，包括回归表格、核心发现提示框、底部注释。直接替换数字即可。

④ 致谢结尾页

复用封面的深蓝样式，简洁大方。

使用建议：

先改封面（标题、作者、单位）
按需增减”节标题页 → 内容页”的组合
把数据表格里的数字替换成你的结果
不需要的功能直接删掉就行

觉得太复杂？

可以先用 marp03_styled 或 marp04_twocol，等熟悉了再升级到 marp05_paper。

或者，把 marp05_paper.md 直接给 AI 看，告诉它”保留这个风格，帮我把内容替换成关于……的论文汇报”，AI 会帮你完成大部分工作。

6.8 marp06_data：数据分析汇报模板

难度： ⭐⭐⭐
适合： 数据分析报告、实证结果展示、研究汇报

以图表和数据呈现为核心，内置 KPI 卡片、双图对比、回归结果+解读双栏等版式，适合有大量数据和图表要展示的场合。

特色功能：

① KPI 数字卡片（三栏，带涨跌色）

<div class="kpi-row">
<div class="kpi-card">
<div class="num">3,842</div>
<div class="label">样本量</div>
<div class="delta">↑ 12.3% 较上期</div>
</div>
<!-- 再加两个 kpi-card ... -->
</div>

② 左图右文（图 60%，文字 40%）

使用 .chart-cols class，右侧配合 .finding（绿色发现框）和 .insight（黄色洞察框）排版解读文字。

③ 双图并排（各 50%）

使用 .chart-cols-half class，两张图并排，各配独立图注。

④ 左表右结论

回归结果表放左边，右边用 .finding 和 .insight 框写核心发现，逻辑清晰。

图片占位

模板里的图片路径（如 ./Figs/trend.png）是占位符，替换成你的实际图片路径即可。如果图片还没准备好，可以先用 <div style="background:#e3f2fd;height:200px;border-radius:6px;"></div> 做占位块。

6.9 marp07_teaching：课程教学模板

难度： ⭐⭐⭐
适合： 课程讲授、知识点讲解、逐步推导演示

以”教学流程”为核心，设计了板书风格的代码展示区、带编号的步骤列表、左错右对的对比框，以及高亮定义框——适合需要一步步引导学生思考的课堂讲授场景。

特色功能：

① 步骤列表（带状态：已完成 / 当前 / 待讲）

<div class="step-row">
  <div class="step-num done">✓</div>   <!-- 绿色：已讲 -->
  <div>内容已讲</div>
</div>
<div class="step-row">
  <div class="step-num now">→</div>    <!-- 橙色：当前 -->
  <div>本节重点内容</div>
</div>
<div class="step-row">
  <div class="step-num">4</div>        <!-- 蓝色：待讲 -->
  <div>后续内容</div>
</div>

② 板书区域（深色背景，等宽字体）

<div class="board">
<span class="comment"># 注释文字（灰色斜体）</span>
<br>
关键变量：<span class="hl">高亮内容（青色）</span>
<br>
结论：<span class="result">结果高亮（黄色）</span>
</div>

③ 左错右对对比框

<div class="compare">
<div class="wrong">❌ <strong>错误做法：</strong>说明</div>
<div class="right">✅ <strong>正确做法：</strong>说明</div>
</div>

④ 定义框（蓝色边框，带标签）

<div class="def">
<div class="label">📌 定义：工具变量</div>
正式定义写在这里……
</div>

关于”逐步揭示”

Marp 不支持 PowerPoint 那种点击动画逐步显示内容。这个模板用步骤列表的状态样式（已完成 / 当前 / 待讲）来模拟”当前讲到哪里”的视觉效果，配合手动 --- 分页来实现逐步推进的感觉。

6.10 marp08_report：政策报告 / 工作汇报模板

难度： ⭐⭐⭐
适合： 政策研究报告、政府汇报、部门工作汇报、咨询报告

采用绿色系商务配色，封面设计为左右分栏（左侧深色信息栏 + 右侧标题区），整体风格简洁、正式、有说服力。

特色功能：

① 左右分栏封面（左侧深绿信息栏）

封面不使用全页背景图，而是左右分区，左侧放单位/日期/标签，右侧放标题和汇报人信息，层次清晰。

② 要点列表增强（绿点 + 分隔线）

<ul class="bullet-list">
<li>要点一：说明文字</li>
<li>要点二：说明文字</li>
</ul>

③ 带标签的要点（彩色小标签）

<span class="label-tag">重点</span> 说明文字

④ 引用框（左边绿色竖线，斜体文字）

<div class="quote">
"政策引用或权威表述……"
<br><span style="font-size:13px;">—— 文件名称，年份</span>
</div>

⑤ 数字高亮（绿色加粗数字）

核心指标：<span class="highlight-num">12.3%</span>

⑥ 建议卡片网格（2×2，带顶部绿色边框）

<div class="rec-grid">
<div class="rec-card">
<h3>建议一：标题</h3>
<p>具体措施说明。</p>
</div>
<!-- 再加三个 rec-card -->
</div>