hehaiguang1123
a6f05ab2d5
- Phase 0: AGENTS.md cleanup (dedup quotes, renumber sections, merge qmd) - Phase 1: typed relations (manage-relations.py, graph-search.py, check-staleness.py, detect-conflicts.py) - Phase 2: frontmatter validator, weekly lint, knowledge promotion, git hooks - Fix .gitignore to track tools/ and .githooks/ - Fix git remote URL (remove plaintext token) - New wiki pages: 504 pages, 34 raw sources
314 lines
6.4 KiB
Markdown
314 lines
6.4 KiB
Markdown
---
|
||
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 嵌入（文件更大） -->
|
||
|
||
```
|
||
|
||
---
|
||
|
||
## 🚀 下一步优化
|
||
|
||
### 可选增强
|
||
|
||
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 分钟内完成你的演示。
|