Thanks, Todd, for the reference to CommonMark - I did not know about it before now, and now this thread makes more sense to me.
I’ve been running a phpBB board for 22 years now, and over the years I hacked it quite a bit to meet my needs: Gallery display, support for inline PDFs, Litebox, and captioning (with/without Litebox). When you mentioned figcaption, it triggered me. Here’s a snippet from attachment.html, a template that I hacked:
`<figure><a data-fancybox="gallery1" href="{_file.U_DOWNLOAD_LINK}" data-caption="{_file.COMMENT}"><img src="{_file.THUMB_IMAGE}" class="postimage" alt="{_file.DOWNLOAD_NAME}" title="{_file.DOWNLOAD_NAME} ({_file.FILESIZE} {_file.SIZE_LANG}) {_file.L_DOWNLOAD_COUNT}" /></a>
<!-- ENDIF -->
<!-- IF _file.COMMENT --><figcaption>{_file.COMMENT}</figcaption><!-- ENDIF -->
</figure>`
Our friend figcaption.
It’s time for me to move on from phpBB; it’s outlived its usefulness, and Discourse is a much more robust platform. But - while I can’t speak authoritatively regarding CommonMark, or why it should be adhered to - I can say that the inability to caption images, PDFs, video, audio, etc. in Discourse is for me a serious omission. However it is handled, there should be some provision.
Just my $0.02.
-Dan