Embed

Embed external content (YouTube, Twitter, etc.) directly in the page.

Syntax

Captions are supported by adding a [caption] line immediately below the block.

[embed](https://example.com)
[caption] Caption text

Examples

[embed](https://www.youtube.com/watch?v=dQw4w9WgXcQ)
[caption] Product walkthrough

[embed](https://twitter.com/user/status/123456789)
[caption] Key announcement

Builder

from notionary.markdown import MarkdownBuilder

markdown = (MarkdownBuilder()
  .h2("Demo Video")
  .embed("https://www.youtube.com/watch?v=example", "Product walkthrough")
  .paragraph("See the features in action.")
  .build())

Notion API Reference

For the official Notion API reference on embed blocks, see https://developers.notion.com/reference/block#embed