[HTML] add media embeding example as natively supported by Pandoc

What would you like to do?

Give feedback or suggest an improvement

Description

Pandoc supports for Image syntax ![](media), a mimetype guesser which will in HTML use audio, video or embed tag.
https://github.com/jgm/pandoc/blob/8613aa39e8b5b8282f30b9fd48b04ec2595ec8eb/src/Text/Pandoc/Writers/HTML.hs#L1589-L1594

We could document this syntax better as it is hard to find and know. We could also link from there to video shortcode (https://quarto.org/docs/authoring/videos.html) as a better solution.

Some extensions exists for this already:

• https://github.com/jmgirard/embedpdf
• https://github.com/coatless-quarto/embedio

We don't have great PDF embedding built-in yet too, and we can maybe provide something better than default one. 🤔 I'll open an issue maybe keep track of the idea and get votes.