Home → Questions →

Transclude

• Edit

velarde.vines

31 Jan, 2015 06:45 PM

Can't understand how Transclude works. I selected some text then chose File > Transclude to New File. I assumed the selected text would be written to a new file for me to name and transclusion tags would be inserted in the original file. Or something like that.

But the entire files was duplicated from what I can tell.

Thanks for advice. I checked help but could not find how to.

--Bill

1. Support Staff 1 Posted by Fletcher on 31 Jan, 2015 07:03 PM

   

   Bill,

   Thanks for writing in!

   "Transclude to new file" creates a new file by substituting all transclusion tags with the contents of their files. This allows you to see the entire document at once.

   To "embed" a file, use the standard MultiMarkdown syntax:

   http://fletcher.github.io/MultiMarkdown-4/transclusion

   The Pro version of MultiMarkdown Composer 3 (in development, no release date yet), will offer a feature that takes a highlighted selection of text and moves it to a new file for you.

   Fletcher

   --
   Fletcher T. Penney
   Manager, Founder
   MultiMarkdown Software, LLC
   [email blocked]

   • Edit

2. 2 Posted by velarde.vines on 31 Jan, 2015 07:14 PM

   

   Thanks for the quick response Fletcher. I understand now. I did receive
   the version 3 public beta release message and will install it to check out
   the new transclude feature.

   --Bill

   • Edit

3. Support Staff 3 Posted by Fletcher on 31 Jan, 2015 07:53 PM

   

   Just to be clear - that new feature is only in the Pro version, not in the standard version. Regular transclusion functionality is still in the standard version.

   F-

   --
   Fletcher T. Penney
   Manager, Founder
   MultiMarkdown Software, LLC
   [email blocked]

   • Edit

4. 4 Posted by tfjunk on 25 Apr, 2015 03:17 PM

   

   I'm also trying to figure out what behavior to expect. Using both MMDC2 and MMDC3Pro beta, I have the following line:

   {{header.html}}

   In the Preview (both apps), I just see this text. I would have expected it to do the transclusion when previewing. Do you have to manually choose "Transclude to new file" every time you want to see the full layout?

   TIA

   • Edit

5. Support Staff 5 Posted by Fletcher on 27 Apr, 2015 11:53 AM

   

   Because transclusion can be used to generate large/complex documents
   (e.g. the MultiMarkdown User's Guide), Composer does not perform
   transclusion until you tell it to via the "Transclude to new file"
   command. Doing this for a live preview with every keystroke could hurt
   performance in longer documents.

   • Edit

6. 6 Posted by Steve Audette on 10 Mar, 2016 05:51 PM

   

   Note, if you preview with Marked, these transcluded sections are rendered.

   Marked also has it's own transclusion syntax:

       <<[file.txt]

   • Edit

7. Support Staff 7 Posted by Fletcher on 10 Mar, 2016 11:00 PM

   

   To be clear, Marked's transclusion syntax is not MultiMarkdown, nor will it ever be. That syntax will only work for Marked.

   • Edit

8. Fletcher closed this discussion on 13 Oct, 2017 02:02 PM.