---
categories:
  - '[[LLM Wiki]]'
tags:
  - wiki
  - reference
  - marp
created: 2026-04-10
source: '[[Marp 优化-快速上手指南]]'
type: reference
---

# Marp 优化 - 使用指南

> 你的 Marp 工作流已优化完成！5 分钟快速上手。

## 🎉 优化内容概览

### 新增资源

1. **Marp 模板库** (`wiki/Marp 模板库.md`)
   - 完整的模板使用指南
   - 文件组织结构说明
   - 主题选择建议

2. **三个实用模板** (`Presentations/Templates/`)
   - 学术答辩模板.md
   - 技术分享模板.md
   - 商务汇报模板.md

3. **两个自定义主题** (`Templates/MarpTheme/`)
   - university-blue.css（学术蓝）
   - minimal-dark.css（极简深色）

4. **批量导出脚本** (`export-slides.bat`)
   - 一键导出 PDF/PPTX/HTML
   - 自动统计文件数量

---

## ⚡ 5 分钟快速开始

### 步骤 1：创建新演示（1 分钟）

从模板库复制模板：

```
1. 打开 Presentations/Templates/
2. 选择合适的模板（学术/技术/商务）
3. 复制模板内容
4. 粘贴到 Presentations/Active/新文件.md
```

### 步骤 2：编辑内容（2 分钟）

在 Obsidian 中编辑：

```
1. 打开 Presentations/Active/新文件.md
2. 替换 {占位符} 为实际内容
3. 按 Ctrl+P 打开命令面板
4. 输入 "Marp: Open Preview"
```

### 步骤 3：预览效果（1 分钟）

拆分预览窗口：

```
1. 预览窗口在右侧打开
2. 左侧编辑，右侧实时预览
3. 使用 `
---` 分页
```

### 步骤 4：导出（1 分钟）

批量导出演示：

```
方法 1：Obsidian 插件导出
  - 点击预览窗口的导出按钮
  - 选择 PDF/PPTX/HTML
  - 保存到 Downloads

方法 2：批量导出脚本（推荐）
  1. 双击 export-slides.bat
  2. 自动导出所有演示
  3. 导出结果在 Presentations/Export/
```

---

## 🎨 主题快速切换

### 学术场景

```markdown
---
marp: "true"
theme: university-blue
footer: XX大学 · 计算机科学学院
---
```

### 技术场景

```markdown
---
marp: "true"
theme: minimal-dark
---
```

### 两栏布局示例

```markdown
<!-- _class: cols-2 -->

<div class="ldiv">

### 左栏内容

- 要点 1
- 要点 2

</div>

<div class="rdiv">

### 右栏内容

```javascript
const example = "code here"
```

</div>
```

### 特殊页面类型

| 指令 | 用途 | 示例 |
|
------|------|------|
| `<!-- _class: cover -->` | 封面页 | 论文答辩首页 |
| `<!-- _class: trans -->` | 过渡页 | 章节分隔 |
| `<!-- _class: dark -->` | 深色页 | 强调内容 |
| `<!-- _class: cols-2 -->` | 两栏布局 | 左右对比 |
| `<!-- _class: lead -->` | 居中大标题 | 核心要点 |
| `<!-- _class: ending -->` | 结束页 | 致谢 |

---

## 📁 目录结构说明

```
kepano-obsidian-main/
├── wiki/
│   ├── Marp 模板库.md           # 模板使用指南
│   ├── Marp.md                 # Marp 概念页
│   ├── 示例-学校定制Marp演示.md  # 完整示例
│   └── ...
├── Presentations/
│   ├── Templates/               # 演示模板（3个）
│   ├── Themes/                  # 自定义主题（2个）
│   ├── Active/                  # 当前进行中的演示
│   └── Export/                  # 导出结果（自动生成）
│       ├── PDF/                # PDF 文件
│       ├── PPTX/               # PPTX 文件
│       └── HTML/               # HTML 文件
├── Templates/
│   └── MarpTheme/             # 主题文件
│       ├── university-blue.css   # 学术蓝主题
│       └── minimal-dark.css      # 极简深色主题
└── export-slides.bat              # 批量导出脚本
```

---

## 🔧 高级技巧

### 1. 快速替换内容

使用 Obsidian 的搜索替换：

```
1. Ctrl+H 打开查找替换
2. 查找：{占位符}
3. 替换为：实际内容
4. 全部替换
```

### 2. 实时查看主题效果

在同一个文件中快速测试不同主题：

```markdown
# 测试 university-blue
---
theme: university-blue

# 测试 minimal-dark
---
theme: minimal-dark
```

### 3. 使用 Obsidian 内置功能

- **Wikilink 图片**：`![[image.png]]`
- **代码块语法高亮**：\`\`\`javascript
- **表格**：直接用 Markdown 表格语法
- **引用**：`> 引用内容` 或 `> [!note] 内容`

### 4. 导出配置自定义

编辑 `export-slides.bat` 可以自定义：

```batch
REM 修改导出目录
set "EXPORT_DIR=%~dp0Export"

REM 修改主题目录
set "THEME_DIR=%~dp0Themes"
```

---

## ❓ 常见问题

### Q: 添加新主题后主题列表没有显示？

A: 需要**重启 Obsidian**。这是插件的限制。

### Q: 如何调整主题颜色？

A: 编辑 CSS 文件中的颜色变量：

```css
:root {
  --color-primary: #003366;       /* 修改这里 */
  --color-secondary: #1a6fb5;     /* 修改这里 */
  --color-accent: #c8102e;        /* 修改这里 */
}
```

### Q: PPTX 导出后在 PowerPoint 中无法编辑？

A: 这是正常的。Marp 的 PPTX 导出是将每页转换为图片后嵌入 PPTX，满足格式要求即可。

### Q: 如何导出特定页面？

A: 使用 Marp CLI 的 `--page-number` 参数：

```bash
marp presentation.md --pdf -o output.pdf --page-number 1,3,5
```

### Q: 演示文件太大怎么办？

A: 使用图片优化：

```markdown
<!-- 使用 wikilink 引用图片（更高效） -->
![[image.png]]

<!-- 而不是 Base64 嵌入（文件更大） -->
![alt](data:image/png;base64,...)
```

---

## 🚀 下一步优化

### 可选增强

1. **添加更多主题**
   - 从 GitHub 下载社区主题：[marp-themes](https://github.com/marp-team/awesome-marp)
   - 放入 `Templates/MarpTheme/` 目录
   - 重启 Obsidian

2. **创建自定义模板**
   - 基于现有模板修改
   - 保存为新模板
   - 更新 `Marp 模板库.md`

3. **集成到 CI/CD**
   - 在 GitHub Actions 中自动导出
   - 每次提交生成 PDF/PPTX

4. **使用 Git 管理演示**
   - 版本控制所有演示文件
   - 方便团队协作
   - 追溯历史版本

---

## 📚 相关文档

---
## 相关页面

详见 [[Marp 优化-快速上手指南]]

- [[Marp 模板库]] — 完整模板库
- [[Marp]] — Marp 概念总览
- [[Marp 指令语法]] — 指令参考
- [[Marp 主题与样式]] — 主题和 CSS
- [[Obsidian Marp 插件]] — 插件使用指南
- [[示例-学校定制Marp演示]] — 完整示例

---

**开始创建你的第一个演示吧！** 🎉

从 `Presentations/Templates/` 复制模板，5 分钟内完成你的演示。

## 来源

> **溯源规则**：所有数字/百分比/具体结论必须标注 `[raw:{文件名}:{行号}]` 格式。

- [[Marp 优化-快速上手指南]]