# ppt-maker

一键将 Markdown 转换为专业 PPT，支持自动图表生成和多种主题。

## Architecture

![Architecture](assets/ppt-maker-architecture.svg)

## Workflow

![Workflow](assets/ppt-maker-workflow.svg)

## 功能特性

- Markdown 语法驱动幻灯片布局（封面页、内容页、结束页）
- 表格数据**自动转为图表**（饼图 / 柱状图 / 折线图）
- 6 种内置主题：ocean、sunset、purple、luxury、midnight、classic
- 支持有序/无序列表、引用块、代码块、表格

## 快速开始

```bash
node skills/ppt-maker/scripts/ppt-maker.js -i input.md -o output.pptx -t ocean
```

## 命令参数

| 参数 | 说明 | 必填 |
|------|------|------|
| `-i` | 输入 Markdown 文件 | ✅ |
| `-o` | 输出 PPTX 文件 | ✅ |
| `-t` | 主题名称（默认 ocean） | ❌ |
| `-l` | 列出所有可用主题 | ❌ |

## Markdown 页面结构

```markdown
# 封面标题          → 封面页
副标题文字

## 章节标题         → 内容页
## 感谢聆听         → 结束页（自动识别）
```

## 图表自动生成

在标题中包含关键字，其下方表格自动转为对应图表：

| 图表类型 | 触发关键字示例 |
|----------|--------------|
| 🥧 饼图 | 占比、比例、饼图、pie |
| 📊 柱状图 | 对比、排名、销售额、bar |
| 📈 折线图 | 趋势、增长、月度、line |

## File Structure

```
skills/ppt-maker/
├── SKILL.md
├── README.md          # this file
├── _meta.json
├── assets/
│   ├── workflow.puml
│   └── ppt-maker-workflow.svg
└── scripts/
    ├── ppt-maker.js   # 主脚本
    └── package.json   # 依赖 pptxgenjs
```

## 示例提示词

```
请使用 ppt-maker 技能，为我生成一份"2026年度销售总结"的汇报型幻灯片，
包含销售占比饼图、各产品销售额柱状图、月度趋势折线图，主题使用 midnight。
```