velarde.vines's Avatar


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.


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

    Fletcher's Avatar


    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:

    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 T. Penney
    Manager, Founder
    MultiMarkdown Software, LLC
    [email blocked]

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

    velarde.vines's Avatar

    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.


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

    Fletcher's Avatar

    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.


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

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

    tfjunk's Avatar

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


    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?


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

    Fletcher's Avatar

    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.

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

    Steve Audette's Avatar

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

    Marked also has it's own transclusion syntax:


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

    Fletcher's Avatar

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

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

Comments are currently closed for this discussion. You can start a new one.

Keyboard shortcuts


? Show this help
ESC Blurs the current field

Comment Form

r Focus the comment reply box
^ + ↩ Submit the comment

You can use Command ⌘ instead of Control ^ on Mac