Problem with file transclusion

enrico.scarpella's Avatar


01 Jun, 2019 12:45 AM

Dear Fletcher,

I am having a problem with file transclusion, and I was wondering whether you could be so kind to help me.

I created a transclusion file (see attached "Transclusion File" screenshot, which shows part of it). I then used the "File > Transclude to New File" function, but the transclusion is incomplete (see attached "Transcluded File" screenshot, which shows part of it). As you can see, the first and fourth files were included in the transclusion, but the second and third were not. Actually, the first time I had tried this, the first file had not been included in the transclusion either, but I solved that problem by adding the ".md" suffix to the file name, which is in itself strange because all the files to be included in the transclusion and the transclusion file itself were created with Composer, and I never add an ".md" suffix to the file name because I had selected "md" as default file extension in the Preferences. Nevertheless, I then proceeded to add the ".md" suffix to the second and third files, but this time the stratagem failed to solve the problem. The names of the files are written properly in the transclusion file, as you can see from the "File Names" screenshot, which also shows that the fourth file to be included in the transclusion indeed lacks the ".md" suffix, and yet it was included in the transclusion.

I have performed the same transclusion using Marked 2 with the same files (but with a different transclusion file because Marked uses a different syntax to indicate transclusion), and it worked perfectly, which would suggest that the problem is with Composer, but I cannot think of anything; would you have any suggestion?

Thank you for your consideration.

Best regards,

  1. Support Staff 1 Posted by Fletcher on 01 Jun, 2019 01:26 AM

    Fletcher's Avatar

    Are you sure that the files do/don't have the file extensions you think they do? Did you do a "Get Info" in the finder to see the actual filenames, and not just the filenames as they are displayed?

  2. 2 Posted by enrico.scarpell... on 01 Jun, 2019 04:01 AM

    enrico.scarpella's Avatar

    Thank you for your prompt response, Fletcher.

    Yes, I am sure: for example, see the attached screenshot of the "Get Info" window for those files, which matches the "File Names" screenshot in my opening post (i.e. extension shown for the first three files and hidden for the fourth one).

    Moreover, as mentioned, the very same files transclude perfectly through Marked 2 by using, in a transclusion file with the Marked 2 transclusion syntax, the very same file names and extensions I had used in the transclusion file I created to transclude through Composer.

    Thank you for your consideration.

    Best regards,

  3. Support Staff 3 Posted by Fletcher on 01 Jun, 2019 10:18 AM

    Fletcher's Avatar

    Brett uses a different transfusion mechanism in Marked, so that doesn’t help figure out what is happening.

    If you can send me the relevant files, I can take a look and see what’s happening.


    Sent from my iPhone

  4. 4 Posted by enrico.scarpell... on 01 Jun, 2019 01:15 PM

    enrico.scarpella's Avatar

    Thank you for your willingness to look into that, but I can't send you the files: they are of an unpublished manuscript I am working on with collaborators.

    I'll see whether I can recreate the problem with files of scrambled text; if so, I'll get in touch; if not, I'll keep on using Marked for now. Thank you again.

    Best regards,

  5. Support Staff 5 Posted by Fletcher on 01 Jun, 2019 04:42 PM

    Fletcher's Avatar

    I can't replicate it.

    Are you sure that Composer has permission to access all the files? Does the preview work properly? (assuming you have transclusion enabled in the MMD preferences)

  6. 6 Posted by enrico.scarpell... on 01 Jun, 2019 07:52 PM

    enrico.scarpella's Avatar

    Thank you for not giving up.

    For some unknown reason, I can not replicate the issue either: today, everything works just fine, even though I have not changed anything: I have not restarted Composer or the computer; since yesterday, I did quit a few applications, though (e.g., Marked 2, Tinderbox 8, DTPO/DT3 and SublimeText 3). I wondered whether any of those were somehow interfering, so I re-opened them all, but no: file transclusion through Composer still works perfectly... So I am not sure what to say, other than I am sorry for wasting your time. Thank you for bearing with me.

    Best regards,

  7. Support Staff 7 Posted by Fletcher on 01 Jun, 2019 08:01 PM

    Fletcher's Avatar

    No problem -- glad it's working!

    The only things that make any sense to me:

    1. Maybe two of the file extensions were missing early on in the process and got fixed during testing?

    2. A file permission issue related to sandboxing?

    If it happens again, let me know and we'll try again.


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

  8. 8 Posted by enrico.scarpell... on 01 Jun, 2019 09:00 PM

    enrico.scarpella's Avatar

    Thank you very much again for your help and support and for your availability!

    Best regards,

Reply to this discussion

Internal reply

Formatting help / Preview (switch to plain text) No formatting (switch to Markdown)

Attaching KB article:


Already uploaded files

  • Transclusion_FIle.png 297 KB
  • Transcluded_File.png 1.27 MB
  • File_Names.png 254 KB

Attached Files

You can attach files up to 10MB

If you don't have an account yet, we need to confirm you're human and not a machine trying to post spam.

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