Skip to content

Video Blocks

Video blocks embed content from YouTube, Vimeo, or direct file URLs. Ideal for tutorials, demos, and training.

Basic Syntax

[video](https://youtube.com/watch?v=VIDEO_ID)
[video](https://vimeo.com/VIDEO_ID)
[video](https://example.com/video.mp4)

Quick Examples

## Product Demo

[video](https://youtube.com/watch?v=dQw4w9WgXcQ "New Features Overview")

## Training Module

[video](https://vimeo.com/123456789 "Authentication Basics - 15 min")

## Direct File

[video](https://cdn.example.com/tutorial.mp4 "Installation Walkthrough")

Captions & Context

[video](https://youtube.com/watch?v=api_tutorial "Duration: 15 min | Beginner Level")

Programmatic Usage

Using MarkdownBuilder

from notionary import MarkdownBuilder

builder = (MarkdownBuilder()
    .h1("Developer Training Program")
    .h2("Module 1: Getting Started")
    .video("https://youtube.com/watch?v=intro123", "Introduction - 10 minutes")
    .paragraph("Key concepts covered:")
    .bulleted_list([
        "Platform overview",
        "Basic navigation",
        "Account setup"
    ])
    .h2("Module 2: API Fundamentals")
    .video("https://youtube.com/watch?v=api456", "API Basics - 15 minutes")
    .paragraph("Learn about:")
    .bulleted_list([
        "Authentication methods",
        "Making requests",
        "Handling responses"
    ])
)

print(builder.build())
  • Image – For static visuals
  • Audio – For audio-only content
  • File – For downloadable media
  • Embed – For other embeddable content