1. 简介
Awesome Marp 是一套基于 Marp 的自定义主题模板，让您能够轻松地使用 Markdown 创建美观的演示文稿，无需掌握复杂的 LaTeX Beamer 或 PowerPoint 操作。本模板集成了多种预设样式，包括各种颜色主题、分栏布局、引用盒子等，让您专注于内容创作而非排版设计。
当前版本（v1.3）提供：
- 6种主题颜色（深色、绿色、红色、蓝色、棕色、紫色）
- 38种自定义样式
- 5种封面页设计
- 灵活的页面分栏和列表分列方式
- 各种引用盒子、导航栏等特色功能
2. 环境准备
2.1 所需工具
- Markdown 编辑器：推荐使用以下两种
- VS Code：下载地址
-
Obsidian：下载地址
-
插件安装
- VS Code 用户：安装 Marp for VS Code
-
Obsidian 用户：安装 Marp Slides 插件
-
字体（可选但推荐）
- 正文字体：
Latin Modern Math、方正宋刻本秀楷简体（未安装时默认使用Calibri和楷体） - 标题字体：
Optima LT Medium、方正苏新诗柳楷简体（未安装时默认使用Arial和黑体） - 脚注字体：
Charm和叶根友毛笔行书修正版（未安装时默认使用Calibri和楷体） - 代码字体：
Fira Code和霞鹜文楷等宽（未安装时默认使用Consolas和华文中宋） - 字体文件打包下载:
2.2 准备工作
- 将
Awesome-Marp文件夹下载到本地 - 下载链接
- 推荐在终端使用
git clone https://github.com/favourhong/Awesome-Marp.git拉取仓库,或者先fork一份到自己的GitHub上再拉取 - VS Code 用户：直接使用 VS Code 打开整个
Awesome-Marp文件夹 - Obsidian 用户：配置 Marp Slides 插件并设置对应的 CSS 路径
3. 创建你的第一个演示文稿
3.1 基本设置
创建一个新的 .md 文件，在文件顶部添加 YAML 前置元数据：
---
marp: true # 启用 Marp
size: 16:9 # 幻灯片比例（16:9 或 4:3）
theme: am_blue # 选择主题颜色（am_blue, am_dark, am_green, am_red, am_brown, am_purple）
paginate: true # 显示页码
headingDivider: [2,3] # 使用二级和三级标题自动分页
footer: \ *你的名字* *演讲标题* *日期* # 设置页脚内容
---
3.2 创建封面页
<!-- _class: cover_a -->
<!-- _header: "" -->
<!-- _footer: "" -->
<!-- _paginate: "" -->
# 你的演讲标题
###### "演讲副标题"
@你的名字
机构名称
日期：2025 年 5 月 9 日
联系方式
3.3 添加目录页
<!-- _class: cols2_ol_ci fglass toc_a -->
<!-- _footer: "" -->
<!-- _header: "CONTENTS" -->
<!-- _paginate: "" -->
- [第一章](#3)
- [第二章](#10)
- [第三章](#15)
- [第四章](#20)
3.4 内容页面创建
每个内容页面使用 ## 或 ### 开始（根据 headingDivider 设置）：
## 第一章
这里是第一章的内容，可以使用普通的 Markdown 语法：
- 列表项 1
- 列表项 2
- 列表项 3
> 这是一个引用
4. 使用特色样式
4.1 页面分栏
Awesome Marp 提供了多种分栏方式：
两栏五五分
<!-- _class: cols-2 -->
<div class=ldiv>
左侧内容
</div>
<div class=rdiv>
右侧内容
</div>
两栏六四分
<!-- _class: cols-2-64 -->
<div class=ldiv>
左侧内容（占60%）
</div>
<div class=rdiv>
右侧内容（占40%）
</div>
三栏平分
<!-- _class: cols-3 -->
<div class=ldiv>
左侧内容
</div>
<div class=mdiv>
中间内容
</div>
<div class=rdiv>
右侧内容
</div>
两行分栏
<!-- _class: rows-2 -->
<div class="timg">
顶部内容
</div>
<div class="bimg">
底部内容
</div>
4.2 列表分列
<!-- _class: cols2_ol_ci fglass -->
- 第一项
- 第二项
- 第三项
- 第四项
4.3 引用盒子
<!-- _class: bq-blue -->
> 这是一个蓝色的引用盒子
>
> 第二行内容
可选的引用盒子样式：bq-purple、bq-blue、bq-green、bq-red、bq-black
4.4 导航栏
<!-- _class: navbar -->
<!-- _header: \ ***@标题*** *第一章* *第二章* **当前章节** *第四章* -->
当前页面内容
4.5 其他样式
- 固定标题样式：
fixedtitleA、fixedtitleB - 文字大小调整：
tinytext、smalltext、largetext、hugetext - 图片标题：
caption - 脚注样式：
footnote - 过渡页面：
trans - 最后一页：
lastpage
5. 图片处理
5.1 基本插入
5.2 图片对齐与大小控制
 <!-- 居中对齐 -->
 <!-- 左对齐 -->
 <!-- 右对齐 -->
 <!-- 指定宽度为500px -->
 <!-- 指定高度为300px -->
6. 导出演示文稿
6.1 使用 VS Code
- 打开命令面板（按下
Ctrl+Shift+P或F1） - 输入并选择
Marp: Export slide deck... - 选择导出格式（PDF、HTML、PPTX 等）
- 选择保存位置
6.2 使用命令行（需安装 @marp-team/marp-cli）
# 导出为 PDF
npx @marp-team/marp-cli --pdf 你的文件.md
# 导出为 HTML
npx @marp-team/marp-cli --html 你的文件.md
# 导出为 PPTX
npx @marp-team/marp-cli --pptx 你的文件.md
6.3 使用 Obsidian
如果已安装 Marp Slides 插件，可在 Obsidian 中直接导出。
7. 主题样式一览
Awesome Marp 提供的 38 个自定义样式：
| 封面页 | 目录页 | 列表 | 引用盒子 | 其他 1 | 其他 2 |
|---|---|---|---|---|---|
cover_a |
toc_a |
cols-2 |
bq-black |
过渡页面 trans |
图表等的标题 caption |
cover_b |
toc_b |
cols-2-64 |
bq-purple |
最后一页 lastpage |
非嵌套无序列表的毛玻璃效果 fglass |
cover_c |
cols-2-73 |
bq-red |
导航栏 navbar |
脚注：footnote |
|
cover_d |
cols-3 |
bq-blue |
标题固定+无底色 fixedtitleA |
调节字体大小：tinytext/smalltext/largetext/hugetext |
|
cover_e |
cols-2-46 |
bq-green |
标题固定+有底色 fixedtitleB |
||
cols-2-37 |
两列有序列表 cols2_ol_sq/ci |
||||
rows-2 |
两列无序列表 cols_ul_sq/ci |
||||
pin-3 |
单列有序列表 col1_ul_sq/ci |
Awesome Marp 提供的 6 种主题颜色：
| 深色 | 绿色 | 红色 | 蓝色 | 棕色 | 紫色 |
|---|---|---|---|---|---|
am_dark |
am_green |
am_red |
am_blue |
am_brown |
am_purple |
8. 常见问题解答
8.1 如何修改主题样式？
如果您想修改主题样式，可以编辑 themes 文件夹中对应的 CSS 文件。例如，修改 am_blue.scss 可以自定义蓝色主题的样式。
8.2 如何在不同主题之间切换？
只需在 YAML 前置元数据中修改 theme 属性即可：
theme: am_purple # 切换到紫色主题
8.3 如何组合多种样式？
在一个页面中使用多种样式，只需在 _class 指令中用空格分隔：
<!-- _class: cols-2 fglass -->
Comments NOTHING