llm_wiki/wiki/Marp 优化-快速上手指南.md

categories, tags, created, source, type

categories	tags	created	source	type
LLM Wiki	wiki reference marp	2026-04-10	Marp 优化-快速上手指南	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/

---

🎨 主题快速切换

学术场景

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

技术场景

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

两栏布局示例

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

<div class="ldiv">

### 左栏内容

- 要点 1
- 要点 2

</div>

<div class="rdiv">

### 右栏内容

```javascript
const example = "code here"

```

特殊页面类型

| 指令 | 用途 | 示例 |

<!-- _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. 实时查看主题效果

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

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

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

3. 使用 Obsidian 内置功能

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

4. 导出配置自定义

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

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

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

---

❓ 常见问题

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

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

Q: 如何调整主题颜色？

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

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

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

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

Q: 如何导出特定页面？

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

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

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

A: 使用图片优化：

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

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

---

🚀 下一步优化

可选增强

1. 添加更多主题

   • 从 GitHub 下载社区主题：marp-themes
   • 放入 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 优化-快速上手指南