Markdown to Storyboard

Convert any markdown text into a structured storyboard CSV — the universal handoff format for downstream tools (slide builders, video editors, image generators).

Workflow

1. Analyze the Source Markdown

Read the markdown and identify:

• Title and subtitle
• Section headings (H2/H3) → natural slide boundaries
• Key arguments / data points / quotes per section
• Narrative arc: setup → development → climax → conclusion

2. Ask User Preferences

Prompt for (defaults in parentheses):

• Slide count (auto: 8–15 based on content length, ~1 slide per 150–300 words)
• Audience (general)
• Tone (professional)
• Language (same as source)

If user declines to specify, use defaults and proceed.

3. Assign Slide Types and Layouts

Available slide_type values:

Type	Purpose	Typical layout
cover	Opening slide	full_bg
toc	Table of contents (optional, 12+ slides)	center_text
section	Chapter divider	center_text
content	Core information	left_img_right_text or top_img_bottom_text
quote	Key quote or statistic	full_bg
data	Chart / number-driven	two_column
summary	Closing recap	center_text or left_img_right_text
end	Thank-you / Q&A / CTA	full_bg

Available layout values: full_bg, left_img_right_text, top_img_bottom_text, center_text, two_column

4. Write the Image Prompt for Each Slide

For each slide, write an image_prompt (English, regardless of content language) that:

• Describes a concrete scene, not an abstract concept
• Includes a style keyword consistent across all slides (e.g. "flat vector illustration, soft pastel palette")
• Specifies composition hints matching the layout (e.g. "wide shot, negative space on the right" for left_img_right_text)
• Cover and end slides get more dramatic / visually impactful prompts

5. Draft Speaker Notes

speaker_notes column: 1–3 sentences of what the presenter would say. Leave empty if not requested.

6. Output the CSV

Write the storyboard to storyboard.csv using execute_code:

import csv

rows = [
    # [slide_no, slide_type, title, bullet_points, image_prompt, speaker_notes, layout]
]

header = ["slide_no", "slide_type", "title", "bullet_points", "image_prompt", "speaker_notes", "layout"]

with open("storyboard.csv", "w", newline="", encoding="utf-8") as f:
    writer = csv.writer(f)
    writer.writerow(header)
    writer.writerows(rows)

Column spec:

Column	Type	Description
slide_no	int	1-indexed
slide_type	str	One of the types above
title	str	Slide headline, ≤ 10 words
bullet_points	str	Newline-separated (\n). Each ≤ 20 chars. Max 5 items
image_prompt	str	English prompt for image generation
speaker_notes	str	Optional presenter notes
layout	str	One of the layouts above

7. Present for Review

Display the storyboard as a markdown table for the user to review. Wait for confirmation before the next pipeline step. If changes requested, update storyboard.csv and re-display.

Pacing Guidelines

• Opening (slides 1–2): Hook — cover + bold opening statement or question
• Body (slides 3 to N-2): One idea per slide. Alternate content and quote/data to vary rhythm
• Closing (slides N-1 to N): Summary of key takeaways + end slide
• Avoid consecutive slides of the same type. Insert a section divider between major parts.

Text Density Rules

• Title: imperative or question form, ≤ 10 words
• Bullets: ≤ 5 per slide, each ≤ 20 characters (CJK) / ≤ 12 words (Latin)
• Prefer fragments over full sentences
• Numbers stand alone: "3x faster" not "It is three times faster"