I don't think this is something that is possible today using only markdown files or code source comments since DocC does not permit raw HTML in its markdown input.
I do think there is potential for a future enhancement to allow something like this through the introduction of a new directive possibly. I imagine that supporting YouTube video embedding might require a similar type of functionality and may be a useful feature.