# Transclusion or including sub-documents for reuse

**URL:** <https://talk.commonmark.org/t/transclusion-or-including-sub-documents-for-reuse/270>\
**Category:** Extensions\
**Created:** [September 4, 2014, 10:18am UTC](https://talk.commonmark.org/t/transclusion-or-including-sub-documents-for-reuse/270 "2014-09-04T10:18:45Z")\
**Posts on this page:** 1\
**Showing post:** 12

<div class="post-metadata">

**Author:** ![chrisalley](https://cdn.commonmark.org/user_avatar/talk.commonmark.org/chrisalley/32/906_2.png) [@chrisalley](https://talk.commonmark.org/u/chrisalley)\
**Post date:** [August 23, 2017, 11:28am UTC](https://talk.commonmark.org/t/transclusion-or-including-sub-documents-for-reuse/270/12 "2017-08-23T11:28:28Z")

</div>

The generated HTML from `/images/Structure.jpg (Data Flow)` is:

```auto
<figure>
<img src="images/Structure.jpg" alt="Data Flow" />
<figcaption>Data Flow</figcaption>
</figure>

```

So, the figure caption doubles as the image’s alternative text, making it easier (and less repetitive) to add captioned images to a document quickly.

There was also some [discussion earlier](https://talk.commonmark.org/t/why-not-allow-images-without-alt/617) about making alt text optional in some scenarios (e.g. quickly adding a set of images to a forum post), so this might be a nicer solution for those cases (no empty square brackets). `/images/Structure.jpg` produces:

```auto
<figure>
<img src="images/Structure.jpg" alt="" />
</figure>

```

---

_[View the full topic](https://talk.commonmark.org/t/transclusion-or-including-sub-documents-for-reuse/270)._