# 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:** 9

<div class="post-metadata">

**Author:** ![james](https://talk.commonmark.org/letter_avatar_proxy/v2/letter/j/bc8723/32.png) [@james](https://talk.commonmark.org/u/james)\
**Post date:** [November 23, 2016, 5:19pm UTC](https://talk.commonmark.org/t/transclusion-or-including-sub-documents-for-reuse/270/9 "2016-11-23T17:19:35Z")

</div>

The great text editor iA Writer has introduced content blocks with a new syntax ([https://ia.net/writer/support/general/content-blocks#toc](https://ia.net/writer/support/general/content-blocks#toc)):

```auto
Simple example
/transclude.md 'Example link (title/caption is ignored for text file types)'

```

It would be nice to see a standard syntax emerge for transclusion. Such variation in syntax is frustrating and creates lock-in to specific tooling. As pointed out by @jmatsushita, one of the reasons hercule uses a preceding colon is that it degrades to standard link in environments that don’t support transclusion, reducing the lock-in.

---

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