Skip to main content

Video Script Markdown Template

Plan a video by audience and outcome with timed scenes, visuals, voiceover, on-screen text, B-roll, sound, and platform variants.

Markdown
# Video Script: [Working Title]

**Audience:** [Specific viewer]

**Viewer outcome:** [What they should understand or do]

**Primary platform:** [Platform and format]

**Target duration:** [Length]

**Key message:** [One sentence]

**CTA:** [Relevant next step]

## Production notes

- **Aspect ratio and resolution:** [Verify platform specification]
- **Presenter or voice:** [Name or style]
- **Location or setup:** [Requirements]
- **Accessibility:** [Caption, transcript, contrast, and audio-description needs]

## Scene script

| Time | Purpose | Visual or action | Voiceover or dialogue | On-screen text | B-roll / SFX / music |
| :--- | :--- | :--- | :--- | :--- | :--- |
| 00:00-00:10 | Hook | [Opening shot] | [Spoken line] | [Short text] | [Cue or none] |
| 00:10-00:30 | Context | [Demonstration or presenter] | [Problem and promise] | [Key term] | [B-roll cue] |
| 00:30-01:30 | Main point | [Steps or evidence] | [Explanation] | [Labels or steps] | [SFX cue] |
| 01:30-01:45 | Close | [Result or end card] | [Summary and CTA] | [CTA] | [Music cue] |

## Platform variants

| Variant | Duration | Framing | Opening change | CTA or link placement |
| :--- | :--- | :--- | :--- | :--- |
| [Short vertical] | [Length] | 9:16 | [Platform-specific hook] | [Placement] |
| [Landscape] | [Length] | 16:9 | [Opening] | [Placement] |

## Edit and publishing checklist

- [ ] Read-through matches target timing.
- [ ] Claims and demonstrations are verified.
- [ ] Required footage, B-roll, graphics, and audio are cleared.
- [ ] Captions and transcript are reviewed for accuracy.
- [ ] Text stays within platform-safe areas.
Preview

Video Script: [Working Title]

Audience: [Specific viewer]

Viewer outcome: [What they should understand or do]

Primary platform: [Platform and format]

Target duration: [Length]

Key message: [One sentence]

CTA: [Relevant next step]

Production notes

  • Aspect ratio and resolution: [Verify platform specification]
  • Presenter or voice: [Name or style]
  • Location or setup: [Requirements]
  • Accessibility: [Caption, transcript, contrast, and audio-description needs]

Scene script

TimePurposeVisual or actionVoiceover or dialogueOn-screen textB-roll / SFX / music
00:00-00:10Hook[Opening shot][Spoken line][Short text][Cue or none]
00:10-00:30Context[Demonstration or presenter][Problem and promise][Key term][B-roll cue]
00:30-01:30Main point[Steps or evidence][Explanation][Labels or steps][SFX cue]
01:30-01:45Close[Result or end card][Summary and CTA][CTA][Music cue]

Platform variants

VariantDurationFramingOpening changeCTA or link placement
[Short vertical][Length]9:16[Platform-specific hook][Placement]
[Landscape][Length]16:9[Opening][Placement]

Edit and publishing checklist

  • Read-through matches target timing.
  • Claims and demonstrations are verified.
  • Required footage, B-roll, graphics, and audio are cleared.
  • Captions and transcript are reviewed for accuracy.
  • Text stays within platform-safe areas.

When to use this template

Use this for explainers, tutorials, demonstrations, or short-form adaptations where spoken words, visuals, timing, and production notes must stay synchronized.

Section guide

Audience and outcome
Define what a specific viewer should know or do after watching.
Scene script
Align timing, visual direction, voiceover, text, and audio needs.
Platform variants
Plan intentional changes in duration, framing, captions, and CTA.

How to use this template

  1. 1

    Copy the Markdown

    Click the Copy button above to put the full template on your clipboard.

  2. 2

    Paste into your editor

    Paste into the mdkit editor, a repository, a notes app, or another Markdown editor. Check tables and task lists in your target renderer because Markdown support varies.

  3. 3

    Fill in your content

    Replace bracketed examples with verified information, adapt fields to your context, and remove sections that do not apply.

  4. 4

    Export or share

    Review sensitive information, links, facts, and formatting. Then commit to Git, share the Markdown, or export to HTML or PDF.

Check before you use it

  • Read the script aloud and time it; estimated duration from word count alone can be inaccurate.
  • Confirm licenses, releases, captions, and platform specifications for final assets.

Template details

What it solves

A scene-level script connects the intended viewer outcome to the footage, narration, text, and sound needed in production.

Key features

  • Audience, objective, key message, and CTA
  • Scene timing and visual direction
  • Separate voiceover and on-screen text
  • B-roll, SFX, caption, and platform-variant planning

Pro tips

  • >Use spoken language and read every line at production pace.
  • >Show important information visually instead of making narration carry everything.
  • >Treat captions and on-screen text as planned content, not an afterthought.

Useful Markdown tools

Start in the Markdown editor, then use a relevant tool when you need to format or export the finished document.

Related templates