Embed External Content

[trieloff]

In order to support embeds (OEmbed and Twitter cards, etc.), I suggest following approach:

In the first step, detect embeds and create embed nodes in the MDAST. embeds can take multiple forms:

1. Gatsby-style: `video: https://www.youtube.com/embed/2Xc9gXyf2G4`
2. Link + Image-style: [![Audi R8](http://img.youtube.com/vi/KOxbO0EI4MA/0.jpg)](https://www.youtube.com/watch?v=KOxbO0EI4MA "Audi R8")
3. Link-style: ![](https://www.youtube.com/watch?v=KOxbO0EI4MA)
4. iA-Writer-Style: https://www.youtube.com/watch?v=KOxbO0EI4MA (the URL is the only content of a paragraph)

The embed node will simply take the previous nodes as children, so that normal HTML processing just skips over it.

In the second step, we add a default handler to the #53 VDOM Util, which finds embed nodes in MDAST and outputs the appropriate HTML to embed the referenced content. The handler uses a service (with configurable URL) for generating appropriate HTML representations.