name: marp-slide description: 使用7种精美主题创建专业的Marp演示幻灯片（默认、简约、多彩、黑暗、渐变、科技、商务）。当用户请求创建幻灯片、演示文稿或Marp文档时使用。支持自定义主题、图像布局以及“使其看起来更好”的请求，并自动提升质量。

Marp幻灯片创建器

使用7种预设计主题和内置最佳实践，创建专业、视觉吸引人的Marp演示幻灯片。

何时使用此技能

当用户：

请求创建演示幻灯片或Marp文档时
要求“使幻灯片看起来更好”或“改进幻灯片设计”时
提供模糊指令如“良い感じにして”（使其好看）或“かっこよく”（使其酷炫）时
希望创建讲座或研讨会材料时
需要以项目符号为重点的幻灯片，偶尔包含图像时

快速开始

步骤1：选择主题

首先，根据用户请求和内容确定合适的主题。

快速主题选择：

技术/开发者内容 → 科技主题
商业/企业 → 商务主题
创意/活动 → 多彩或渐变主题
学术/简洁 → 简约主题
一般/不确定 → 默认主题
偏好深色背景 → 黑暗或科技主题

详细主题选择指南，请阅读 references/theme-selection.md。

步骤2：创建幻灯片

首先阅读相关参考资料：
- 始终先阅读 references/marp-syntax.md 了解基本语法
- 对于图像：references/image-patterns.md（官方Marpit图像语法）
- 对于高级功能（数学、表情符号）：references/advanced-features.md
- 对于自定义主题：references/theme-css-guide.md
从适当的模板文件复制内容：
- assets/template-basic.md - 默认主题（最常见）
- assets/template-minimal.md - 简约主题
- assets/template-colorful.md - 多彩主题
- assets/template-dark.md - 黑暗模式主题
- assets/template-gradient.md - 渐变主题
- assets/template-tech.md - 科技/代码主题
- assets/template-business.md - 商务主题
阅读 references/best-practices.md 了解质量指南
遵循最佳实践结构化内容：
- 使用  的标题幻灯片
- 简洁的h2标题（日语5-7字符）
- 每张幻灯片3-5个项目符号点
- 足够的空白
如果需要，使用 references/image-patterns.md 中的模式添加图像
保存到 项目输出目录，扩展名为 .md

可用主题

1. 默认主题

颜色： 米色背景、海军蓝文本、蓝色标题 风格： 干净、精致，带装饰线条 用于： 一般研讨会、讲座、演示 模板： template-basic.md

2. 简约主题

颜色： 白色背景、灰色文本、黑色标题 风格： 极简装饰、宽边距、轻字体 用于： 内容为中心的演示、学术演讲 模板： template-minimal.md

3. 多彩与流行主题

颜色： 粉色渐变背景、多色点缀 风格： 鲜艳渐变、粗体字体、彩虹点缀 用于： 面向年轻人的活动、创意项目 模板： template-colorful.md

4. 黑暗模式主题

颜色： 黑色背景、青色/紫色点缀 风格： 黑暗主题带发光效果、护眼 用于： 技术演示、晚间演讲、现代外观 模板： template-dark.md

5. 渐变背景主题

颜色： 紫色/粉色/蓝色/绿色渐变（每张幻灯片不同） 风格： 每张幻灯片不同渐变、白色文本、阴影 用于： 视觉为中心、创意演示 模板： template-gradient.md

6. 科技/代码主题

颜色： GitHub风格深色背景、蓝/绿色点缀 风格： 代码字体、带#符号的Markdown风格标题 用于： 编程教程、技术聚会、开发者内容 模板： template-tech.md

7. 商务主题

颜色： 白色背景、海军蓝标题、蓝色点缀 风格： 企业演示风格、顶部边框、表格支持 用于： 商业演示、提案、报告 模板： template-business.md

创建幻灯片流程

基本工作流

理解需求
- 识别内容：标题、主题、关键点
- 确定目标受众
- 评估正式程度
选择主题
- 使用上述快速选择规则
- 如果不确定，咨询 references/theme-selection.md
- 如果仍不确定，默认为默认主题
应用模板
- 从 assets/ 加载适当模板
- CSS已嵌入 – 无需外部文件
- 保持模板结构
结构化内容
- 标题幻灯片： + h1
- 内容幻灯片：h2标题 + 项目符号点
- 保持标题5-7字符（日语）
- 使用每张幻灯片3-5个项目符号点
提升质量
- 阅读 references/best-practices.md
- 确保足够空白
- 保持一致性
- 保持文本简洁（每行15-25字符）
添加图像
- 如果需要，咨询 references/image-patterns.md
- 常见：![bg right:40%](image.png) 用于侧边图像
- 使用正确的Marp图像语法
输出文件
- 保存到 项目输出目录
- 使用描述性文件名如 presentation.md

处理“使其看起来更好”请求

当用户给出模糊指令如“良い感じにして”、“かっこよく”或“使其酷炫”时：

从内容推断主题：
- 商业内容 → 商务主题
- 技术内容 → 科技或黑暗主题
- 创意内容 → 渐变或多彩主题
- 一般 → 默认主题
自动应用最佳实践：
- 缩短标题至5-7字符
- 限制项目符号点至3-5项
- 添加足够空白
- 使用一致结构
增强视觉层次：
- 适当时使用h3用于子部分
- 将密集文本拆分为多张幻灯片
- 确保逻辑流程（介绍 → 主体 → 结论）
保持专业语调：
- 匹配内容正式度
- 在列表中使用平行结构
- 保持技术术语一致

图像集成

对于包含图像的幻灯片，咨询 references/image-patterns.md 了解详细语法。

常见模式：

侧边图像： ![bg right:40%](image.png) - 图像在右侧，文本在左侧
居中： ![w:600px](image.png) - 居中，指定宽度
全背景： ![bg](image.png) - 全屏背景
多图像： 多个 ![bg] 声明

示例讲座模式：

## 幻灯片标题

![bg right:40%](diagram.png)

- 解释点1
- 解释点2
- 解释点3

文件输出

始终将最终Marp文件保存到 项目输出目录，扩展名为 .md：

presentation.md
seminar-slides.md
lecture-materials.md

质量检查清单

交付幻灯片前，验证：

[ ] 主题根据内容适当选择
[ ] CSS主题嵌入文件中
[ ] 标题幻灯片使用 
[ ] 所有h2标题简洁（5-7字符）
[ ] 项目符号点每张幻灯片3-5项
[ ] 图像使用正确Marp语法
[ ] 文件保存到输出目录
[ ] 内容遵循最佳实践

参考资料

核心文档

Marp语法： references/marp-syntax.md - 基本Marp/Marpit语法（指令、前页、分页等）
图像模式： references/image-patterns.md - 官方图像语法（bg、滤镜、分割背景）
主题CSS指南： references/theme-css-guide.md - 如何基于Marpit规范创建自定义主题
高级功能： references/advanced-features.md - 数学、表情符号、分段列表、Marp CLI、VS Code
官方主题： references/official-themes.md - 默认、gaia、uncover主题文档

质量与选择指南

主题选择： references/theme-selection.md - 如何为内容选择合适的主题
最佳实践： references/best-practices.md - “酷炫”幻灯片的质量指南

模板与资源

模板： assets/template-*.md - 每个主题的起点，带嵌入CSS（7种主题）
独立CSS： assets/theme-*.css - 供参考的CSS文件（已嵌入模板中）

官方外部链接

Marp官方网站： https://marp.app/
Marpit指令： https://marpit.marp.app/directives
Marpit图像语法： https://marpit.marp.app/image-syntax
Marpit主题CSS： https://marpit.marp.app/theme-css
Marp核心GitHub： https://github.com/marp-team/marp-core
Marp CLI GitHub： https://github.com/marp-team/marp-cli