89 lines
2.4 KiB
Markdown
89 lines
2.4 KiB
Markdown
---
|
||
categories:
|
||
- "[[Marp]]"
|
||
tags:
|
||
- marp
|
||
- presentation
|
||
- markdown
|
||
- 工具
|
||
created: 2026-04-07
|
||
source: "[[marp-guide]]"
|
||
type: concept
|
||
aliases:
|
||
- Marp
|
||
- Marp 生态系统
|
||
---
|
||
|
||
# Marp
|
||
|
||
> **一句话**：用纯 Markdown 写演示文稿的开源生态系统。
|
||
|
||
## 是什么
|
||
|
||
Marp 让你用 Markdown 编写幻灯片，然后导出为 HTML、PDF、PPTX 或图片。不需要 PowerPoint，不需要 Keynote，只需要一个 `.md` 文件。
|
||
|
||
```mermaid
|
||
graph LR
|
||
A["📝 Markdown<br/>源文件"] --> B["⚙️ Marp Core<br/>渲染引擎"]
|
||
B --> C["📄 HTML"]
|
||
B --> D["📋 PDF"]
|
||
B --> E["📊 PPTX"]
|
||
B --> F["🖼️ 图片"]
|
||
```
|
||
|
||
## 核心组件
|
||
|
||
| 组件 | 说明 | 仓库 |
|
||
|------|------|------|
|
||
| **Marpit** | 瘦框架，Markdown → 幻灯片 | [marp-team/marpit](https://github.com/marp-team/marpit) |
|
||
| **Marp Core** | 核心引擎，含内置主题 | [marp-team/marp-core](https://github.com/marp-team/marp-core) |
|
||
| **Marp CLI** | 命令行导出工具 | [marp-team/marp-cli](https://github.com/marp-team/marp-cli) |
|
||
| **Marp for VS Code** | VS Code 实时预览 | [marp-team/marp-vscode](https://github.com/marp-team/marp-vscode) |
|
||
| **Obsidian Marp Plugin** | Obsidian 集成 | [JichouP/obsidian-marp-plugin](https://github.com/JichouP/obsidian-marp-plugin) |
|
||
|
||
## 核心设计理念
|
||
|
||
1. **纯文本优先** — 幻灯片就是 Markdown 文件，用 Git 管理、用任何编辑器打开
|
||
2. **关注点分离** — 内容（Markdown）与样式（CSS 主题）分离
|
||
3. **指令系统** — 通过 HTML 注释或 front-matter 控制幻灯片行为
|
||
4. **模块化** — Marpit（框架）→ Marp Core（引擎）→ CLI/插件（应用层）
|
||
|
||
## 最小示例
|
||
|
||
```markdown
|
||
---
|
||
marp: "true"
|
||
theme: uncover
|
||
paginate: "true"
|
||
---
|
||
|
||
# 标题页
|
||
|
||
---
|
||
|
||
## 第二页
|
||
|
||
- 就这么简单
|
||
- 真的
|
||
```
|
||
|
||
`---` 分页，`marp: true` 启用，`theme:` 选主题。完了。
|
||
|
||
## 关键概念
|
||
|
||
- [[Marp 指令语法]] — 控制幻灯片行为的指令系统
|
||
- [[Marp 主题与样式]] — 内置主题和自定义 CSS
|
||
- [[Marp 主题推荐]] — GitHub 社区优质主题合集与场景推荐
|
||
- [[Marp 导出]] — HTML/PDF/PPTX 导出选项
|
||
- [[Obsidian Marp 插件]] — 在 Obsidian 中使用 Marp
|
||
- [[示例-学校定制Marp演示]] — 学校定制主题的完整演示示例
|
||
|
||
## 相关工具
|
||
|
||
- [[Obsidian]] — 可作为 Marp 的编辑/预览环境
|
||
- [[LLM Wiki]] — Marp 可用于从 wiki 内容生成幻灯片
|
||
|
||
## 来源
|
||
|
||
- [[marp-guide]] — 原始资料汇编
|