Спасибо, Тодд, за ссылку на CommonMark — я не знал о нём до сих пор, и теперь эта тема стала для меня понятнее.
Я уже 22 года работаю с phpBB-форумом и за это время многократно дорабатывал его под свои нужды: галереи изображений, поддержка встроенных PDF-файлов, Litebox и подписи (с Litebox и без). Когда вы упомянули figcaption, это сразу откликнулось. Вот фрагмент из шаблона attachment.html, который я доработал:
`<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>`
Наш друг figcaption.
Пришло время уйти от phpBB: он исчерпал свою полезность, а Discourse — гораздо более надёжная платформа. Но — хотя я не могу авторитетно говорить о CommonMark или о том, почему нужно ему следовать, — могу сказать, что отсутствие возможности добавлять подписи к изображениям, PDF-файлам, видео, аудио и другим материалам в Discourse для меня является серьёзным упущением. Как бы это ни было реализовано, такая возможность должна быть.
Просто моё мнение.
-Дэн