markdown-slides Checked

**Actions**:

1. Identify all image references in source

2. For each image:

   a. Determine appropriate position format
   b. Resolve relative path from slide file location
   c. URL-encode spaces: " " → "%20"
   d. Escape parentheses: "(" → "%28", ")" → "%29"
   e. Verify file exists at resolved path
   f. Use original images when available
   g. Copy missing images to _files_/ directory

3. Apply positioning based on context:

• **Section intros**: Use ![]() for full background
• **Diagrams in text**: Use ![inline]()
• **Default for content slides**: Use ![right fit]() ⭐
• **Custom sizing**: Use ![right XX%]() when needed
• **Full-width inline**: Use ![inline fill]() for wide images

**Examples**:

# Section Title
![](background-image.png)

---

## Content Slide
Key points here:
- Point 1
- Point 2

![right fit](diagram.png)

---

## Inline Diagram
Text before diagram.

![inline](process-flow.svg)

Text after diagram.

### Step 3: Speaker Notes Conversion

**Objective**: Convert appropriate content to speaker notes

**Format**: Lines starting with ^ (caret + space)

**Placement**: At the end of each slide

**Convert to speaker notes**:

✅ Multi-sentence paragraphs

✅ Explanatory text

✅ Additional context

✅ Talking points

**DO NOT convert**:

❌ Single-sentence paragraphs

❌ Lists (bullet or numbered)

❌ Block quotes

❌ Sentences ending with colon (:)

❌ Headers (H1, H2, H3)

❌ Table content

**For Marp platform**: Use HTML comments instead

<!-- This is a speaker note for Marp -->

**Examples**:

## Slide Title

Main content visible to audience.

^ This paragraph becomes a speaker note because it's multi-sentence explanatory text. It provides context that the speaker needs but the audience doesn't need to read on the slide.

---

## Another Slide

- Bullet points stay visible
- Not converted to notes

^ Additional speaking points go here.

### Step 4: Content Enhancement

**Objective**: Polish the presentation for maximum impact

**Actions**:

1. **Add emojis** to section and slide titles:

• Use relevant emojis that enhance meaning
• Don't overuse - keep it professional
• Examples: 🎯📊🤖💡🚀📚🔧⚡

2. **Clean up comments**:

• Remove markdown comments not meant for slides
• Remove TODO items
• Remove internal notes

3. **Ensure clean format**:

• Consistent spacing
• Proper header hierarchy
• Clear slide breaks

4. **Add frontmatter** (if requested):

   slidenumbers: true

5. **Final review**:

• Each slide has clear focus
• Images positioned correctly
• Speaker notes placed at end
• No orphaned content

Critical Guidelines

### Image Handling

⚠️ **CRITICAL RULES**:

1. **NEVER invent images** - Only reference images that exist in the source document or _files_/ folder. Do NOT create placeholder references like background-xxx.png for images that don't exist.

2. **Use original images** from source when available

3. **Copy missing images** to _files_/ directory rather than substituting

4. **Resolve paths per-image** - don't assume same directory

5. **URL-encode spaces**: my file.png → my%20file.png

6. **Escape special characters**:

• Parentheses: ( → %28, ) → %29
• Other special chars as needed

7. **Verify existence** before referencing - run ls or glob to confirm file exists

8. **Maintain semantic relevance** - image should match slide content

9. **Section intros without images are OK** - If no background image exists for a section intro slide, just use the title and speaker notes without an image reference

### Image Position Standards

**Decision tree for image positioning**:

Is it a section intro slide with just title?
  → Does a background image exist?
    → YES: Use ![]() for full background
    → NO: Skip image, use title + speaker notes only

Is it a diagram embedded in flowing text?
  → YES: Use ![inline]() or ![inline fill]()

Is it the main visual for the slide with bullet points?
  → YES: Use ![right fit]() ⭐ PRIMARY FORMAT

Does it need specific sizing?
  → YES: Use ![right 80%]() or other percentage

### Speaker Notes Rules

**When to convert to speaker notes**:

• Multi-sentence explanatory paragraphs
• Contextual information not needed on slide
• Talking points for the speaker
• Additional details for verbal explanation

**When NOT to convert**:

• Single-sentence paragraphs (might be slide content)
• Bullet or numbered lists (usually slide content)
• Block quotes (usually featured content)
• Sentences ending with : (usually introducing lists)
• Any header level
• Table content

**Format**:

Slide content here.

^ Speaker note paragraph one. Can be multiple sentences providing context.

^ Speaker note paragraph two. Each note paragraph gets its own ^ prefix.

### Content Standards

1. **File Naming**:

• Always use - slides suffix
• Preserve original filename otherwise
• Example: AI for PKM.md → AI for PKM - slides.md

2. **Emoji Usage**:

• Add to H1 and H2 headers
• Choose relevant, professional emojis
• Don't overuse - quality over quantity
• Examples:
• 🎯 Goals/Objectives
• 📊 Data/Charts
• 🤖 AI/Technology
• 💡 Ideas/Insights
• 🚀 Future/Launch
• 📚 Learning/Knowledge

3. **Hierarchy**:

• H1 for major sections (usually num