# marp-learn

**Repository Path**: leimiemie/marp-learn

## Basic Information

- **Project Name**: marp-learn
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-02-13
- **Last Updated**: 2026-02-13

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Marp Learn Workspace

这个仓库用于 **多套 PPT（Marp Markdown）并行管理**，但在任意时刻只预览/构建一个 deck。

## 目录结构

```text
.
├─ decks/                     # 每个子目录是一个独立 PPT 项目
│  └─ demo/
│     ├─ slides.md            # 该 deck 的主入口
│     └─ assets/              # 该 deck 的图片/素材
├─ themes/
│  ├─ custom/                 # 自定义主题 css
│  ├─ community/              # 社区下载主题 css
│  └─ README.md
├─ output/                    # 构建产物（pptx）
├─ scripts/
│  ├─ marp.ps1                # list / preview / build
│  ├─ marp.bat
│  ├─ new-deck.ps1            # 新建 deck 脚手架
│  └─ new-deck.bat
├─ .qoder/rules/marp.md       # 给 Qoder AI 的规则上下文
├─ .windsurf/rules/marp.md    # 给 Windsurf AI 的规则上下文
└─ .windsurf/workflows/
```

## 快速开始

### 1) 列出现有 deck

```powershell
.\scripts\marp.ps1 -Action list
```

### 2) 新建一个 deck

```powershell
.\scripts\new-deck.ps1 -Name project-a
```

### 3) 预览（实时监听）

```powershell
.\scripts\marp.ps1 -Action preview -Deck project-a
```

### 4) 生成 PPTX

```powershell
.\scripts\marp.ps1 -Action build -Deck project-a
```

输出文件位于：`output/project-a/project-a.pptx`

## 工作建议流程

1. 在 `decks/<name>/assets/` 放入文本草稿与图片素材。
2. 编辑 `decks/<name>/slides.md`，先完成结构，再填内容。
3. 开启 `preview` 快速迭代。
4. 迭代稳定后执行 `build` 产出 pptx。
5. 需要主题时先放入 `themes/community` 或 `themes/custom`。

详细见：

- `docs/theme-guide.md`
- `docs/ai-collaboration.md`