---
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]] — 原始资料汇编