# Embedded audio and video

**URL:** <https://talk.commonmark.org/t/embedded-audio-and-video/441>\
**Category:** Extensions\
**Created:** [September 6, 2014, 3:00am UTC](https://talk.commonmark.org/t/embedded-audio-and-video/441 "2014-09-06T03:00:25Z")\
**Posts on this page:** 1\
**Showing post:** 102

<div class="post-metadata">

**Author:** ![aoudad](https://cdn.commonmark.org/letter_avatar_proxy/v2/letter/a/b782af/32.png) [@aoudad](https://talk.commonmark.org/u/aoudad)\
**Post date:** [January 16, 2019, 2:15am UTC](https://talk.commonmark.org/t/embedded-audio-and-video/441/102 "2019-01-16T02:15:16Z")

</div>

I think [generic directives](https://talk.commonmark.org/t/generic-directives-plugins-syntax/444?u=aoudad) are the way to go here. Their syntax is general enough to use for pretty much anything, including embedded and/or external content. And since they specify the media type, there’d be no guessing games or corner cases.

As for generic directives’ [dependence on English words](https://talk.commonmark.org/t/embedded-audio-and-video/441/86?u=aoudad), let’s fix that with some [upside-down](https://talk.commonmark.org/t/embedded-audio-and-video/441/87?u=aoudad) syntactic sugar…

```auto
| Media | Directive | Shorthand |
|-------|--------------|-----------|
| Image | :image[](){} | ![](){} |
| Video | :video[](){} | ^[](){} |
| Audio | :audio[](){} | @[](){} |

```

Both the “directive” and “shorthand” syntaxes should be available, so we’d have the best of both worlds. My guess is most people would use the shorthand form.

One issue is, some extensions might already be using these characters for other things – like `^` for superscripts, footnotes, etc. A parser that implements the “shorthand” syntax above would need to give it precedence over those other features.

---

_[View the full topic](https://talk.commonmark.org/t/embedded-audio-and-video/441)._