# md2slide v2 演示
Design-System-Powered Markdown Slides

---

<!--
type: section
-->

# 设计系统 | Design System

---

<!--
type: title
bg: #f8f9fa
-->

# 可控参数 | Controllable

不再只是机械转换 — 每个细节都可调

---

# 主题切换 | Theme Switch

## 四种内置主题

<!-- grid -->

**light**
纯白背景，经典简约

**dark**
GitHub 暗色风格

**minimal**
灰白基调，克制优雅

**accent**
珊瑚红点缀，现代活力

> ℹ️ 使用 `-T theme_name` 切换主题

---

# 动画与比例 | Transitions & Aspect

## 过渡效果

- `none` — 无动画，直接切换
- `fade` — 淡入淡出（默认）
- `slide` — 侧滑进入

## 宽高比

| 参数 | 效果 |
|------|------|
| `auto` | 填满视口（默认） |
| `16:9` | 固定宽屏比例 |
| `4:3` | 固定标准比例 |

> ✅ 组合使用：`--transition slide -a 16:9`

---

# 语义色框 | Semantic Boxes

## 五种情绪

<!-- three-col -->

> ℹ️ Info Box
蓝色边框，用于一般信息提示和说明。

> ⚠️ Warning Box
橙色边框，用于警告用户注意潜在问题。

> ✅ Tip Box
绿色边框，用于最佳实践和推荐做法。

> 🔮 Analogy Box
紫色边框，用于类比、比喻和概念解释。

> ❌ Danger Box
红色边框，用于严重错误和不可逆操作。

---

# Pill 标签 | Inline Badges

## 状态展示

当前系统状态：[pill-green]运行中[/pill]  [pill-blue]v2.1.0[/pill]  [pill-amber]Beta[/pill]

问题分级：[pill-red]P0-严重[/pill]  [pill-purple]P1-高优[/pill]  [pill-gray]P2-普通[/pill]

## 特性标签

[pill-green]已上线[/pill]  [pill-blue]开发中[/pill]  [pill-amber]评审中[/pill]  [pill-purple]规划中[/pill]

---

# 布局控制 | Layout Hints

## Two-Column

<!-- two-col -->

### 左侧优势
- 快速部署
- 版本可控
- 轻量依赖

### 右侧挑战
- 学习曲线
- 团队协作
- 长期维护

---

# 卡片网格 | Card Grid

<!-- grid -->

🚀 **性能**

懒加载、代码分割、SSR 支持

🎨 **设计**

Token 系统、暗色模式、响应式

🔒 **安全**

CSP、Sanitize、Auth 集成

📊 **数据**

实时同步、离线缓存、乐观更新

---

# 代码展示 | Code Blocks

## Python

```python
from dataclasses import dataclass

@dataclass
class Slide:
    title: str
    content: str
    layout: str = "content"

def render(slide: Slide) -> str:
    return f"<h1>{slide.title}</h1>"
```

## Bash

```bash
# 一键生成幻灯片
python md2slide.py talk.md -T dark --toc --footer
```

---

# 表格与数据 | Tables

## 对比矩阵

| 维度 | md2slide | PowerPoint | Keynote | Google Slides |
|------|----------|------------|---------|---------------|
| 编辑速度 | ⚡ 极快 | 🐢 慢 | 🐢 慢 | 🐢 慢 |
| 版本控制 | ✅ Git友好 | ❌ 二进制 | ❌ 二进制 | ❌ 云端 |
| 协作方式 | 📝 PR Review | 📧 邮件传 | 💾 文件传 | 🔗 链接 |
| 可定制性 | 🎨 CSS全控 | 🧩 有限 | 🧩 有限 | 🧩 有限 |
| 离线可用 | ✅ 单文件 | ❌ 需软件 | ❌ 需软件 | ❌ 需联网 |

---

<!--
type: center
-->

# 感谢观看 | Thank You

Made with ❤️ by md2slide v2

左右键翻页 · 空格继续 · Home/End 跳转首尾

---

# 附录：全部参数速查 | Quick Reference

```bash
python md2slide.py talk.md \
  -o output.html       # 输出路径 \
  -t "My Talk"         # HTML标题 \
  -T dark              # 主题：light/dark/minimal/accent \
  --transition fade    # 动画：none/fade/slide \
  -a 16:9              # 比例：auto/16:9/4:3 \
  --toc                # 自动生成目录页 \
  --footer             # 每页显示来源和时间戳 \
  --no-auto            # 关闭自动类型检测 \
  -c custom.css        # 注入自定义CSS
```

> ℹ️ 完整文档见 SKILL.md