Slide Generation

Slide Generation Skill

Generate Marp slides from source content following the AM Blue Course theme and workflow rules.

Quick Start

1. Identify sources: Read all source .md files (or all .md files in a folder) 2. Read references: Load references/rules.md and references/marp-guide.md before generating 3. Design structure: Plan slide sections from source content 4. Generate: Output .md file with Marp format

Input Modes

Single File

User: 生成关于"记忆与检索"的幻灯片，基于第八章.md
→ Read 第八章.md, generate slides

Multiple Files / Folder

User: 把这个文件夹里的内容整合成一组教学幻灯片
→ Read all .md files in the folder, merge by topic/chapter, generate unified slides

When multiple sources are provided:

Output Target

When user specifies an output path (e.g. chapter8/memory-slide.md): 1. Create the output folder (e.g. chapter8/) 2. Copy all used images to chapter8/images/ 3. Write the slide markdown to chapter8/memory-slide.md

Image path mapping:

Marp YAML Header (Required)

Always use this exact header:

---
marp: true
size: 16:9
theme: am_blue_course
paginate: true
headingDivider: [2,3]
footer: '*敬业乐群*'

Required Slide Structure

1. Cover Page (First Slide)

###### [Subtitle]
[Main Title]
@PresenterName

Subtitle format: use ###### (level 6 heading) Main title: use # (level 1 heading)

2. Table of Contents (Second Slide)

## 本节内容



Topic 1
Topic 2
...

3. Content Slides

Use ## (level 2 heading) for main section titles. The headingDivider: [2,3] setting automatically splits pages at ## and ### headings.

For content-heavy pages, apply text-size classes:

For narrow/wide images, avoid left-right layouts; use full-width instead.

Core Rules

Must Follow

Must NOT

Layout Decision Rules

Based on image/table shape:

| Content Shape | Recommended Layout | |---|---| | Wide image (aspect < 1:1) | Full-width, no columns | | Tall image (aspect > 1:1) | Left-right columns possible | | Square image | Flexible, consider columns | | Tables | Full-width or right-aligned; avoid narrow columns | | Code blocks | Full-width, consider tinytext | | Mixed text + image | Use cols-2 (五五分) or cols-2-64 (六四分) |

Image scaling: use !#c w:700 or !#c h:300 to adjust size dynamically.

Column Layout Examples

Two columns (五五分):

Left column content
Right column content

Two columns (六四分, image on left):

!#c
Right column text

fig-top layout (image on top):

!width:850px
Content text

Available Classes

Reference: assets/example_file/AwesomeMarp_blue.md and assets/example_file/slide.md

Page layout: cols-2, cols-2-64, cols-2-73, cols-2-46, cols-2-37, cols-3, rows-2, pin-3

Text size: tinytext, smalltext, largetext, hugetext

Special: toc_a, cover_c, fig-top, fglass, caption, fixedtitleA, fixedtitleB

Callouts: bq-purple, bq-blue, bq-green, bq-red, bq-black

Image Handling

1. Scan source for ![]() image syntax 2. Copy each image file to output images/ folder 3. In slide markdown, reference images relative to output location: ![](images/filename.png) 4. Map original paths (e.g. ../images/8-figures/8-1.png) to new paths (images/8-1.png)

For logos and theme images, use: images/logo.png (copied from assets/images/logo.png)

Multi-Source Synthesis

When synthesizing from multiple sources:

1. Read all sources first — get full picture of content 2. Identify overlap — note repeated topics across files 3. Deduplicate — consolidate overlapping content 4. Merge by structure: - If sources are chapters of the same book → follow chapter order - If sources are different perspectives → create unified section structure - If sources have conflicting info → prefer user's stated preference or most recent 5. Generate one coherent slide deck — unified structure, consistent style

Quality Checklist

Before finishing, verify:

1. Identify sources: Read all source .md files (or all .md files in a folder) 2. Read references: Load references/rules.md and references/marp-guide.md before generating 3. Design structure: Plan slide sections from source content 4. Generate: Output .md file with Marp format