Request to support @youtube

Found in our decoupling migration, the flutter API docs have long embedded instructional videos from the Flutter youtube channel directly into the API docs, for example:

/// {@youtube 560 315 https://www.youtube.com/watch?v=lytQi-slT5Y}

Outside of the Flutter SDK, this is not supported.
For now, we have come up with a workaround for the existing use cases in the decoupled material_ui and cupertino_ui packages:

/// Learn more about [Scaffold] on the [Flutter YouTube channel](https://www.youtube.com/watch?v=lytQi-slT5Y).

But it would be really nice to have this supported. Having rich, interactive and informative API docs is highlighted feature by Flutter developers as part of a great documentation experience.

@isoos

We have https://dart.googlesource.com/dartdoc.git/+/a4a902be/doc/directives.md#youtube-videos

Does it get sanitized on pub.dev? @isoos ?

dartdoc outputs the following snippet, which we remove during sanitization:

  <iframe src="https://www.youtube.com/embed/<video-id>?rel=0" title="YouTube video player" frameborder="0" allow="accelerometer; 
               autoplay; 
               clipboard-write; 
               encrypted-media; 
               gyroscope; 
               picture-in-picture" allowfullscreen="" style="max-width: 560px;
               max-height: 315px;
               width: 100%;
               height: 100%;
               aspect-ratio: 560 / 315;">
</iframe>

Linking this to the discussion in google/dart-neats#402

Navigation Menu

Repository navigation

Request to support @youtube #9490

Metadata

Assignees

Labels

Type

Projects

Milestone

Relationships

Development

Request to support @youtube #9490

Description

Activity

sigurdm commented on Aug 13, 2026

isoos commented on Aug 13, 2026

Metadata

Metadata

Assignees

Labels

Type

Projects

Milestone

Relationships

Development

Issue actions