Transclusion on export

Am I missing something about transclusion? (Forgive me if this is a newbie question, but I haven’t been able to find an answer searching on the forum.)
It’s great to be able to see embedded files in View Mode, but I want to transclude files in a file and then be able to open in default app (Typora etc) and export the whole thing including transcluded files as a single PDF, .docx etc. But all I get with the exported file is the Markdown instruction, not the desired result. Is what I want to do simply not possible at present?


Not possible. Probably never will be.

@bernardo_v, can you expand on why it “never will be”? Is it a bad idea for some reason or technically difficult? I would like this ability also.

1 Like

I am now realizing that not having transclusion on export is actually a huge limitation of Obsidian. Anyone who aims to write anything long-form, using a note primarily made of links (i.e. a Table of Contents note or an outline note) to organize a longer piece, where the links target smaller notes that are paragraphs, will face an unpleasant surprise upon finishing and learning that there is no way (that I can see) to export the whole document without 1) manually cutting and pasting all individual notes or 2) using some external program to parse the markdown files and combine them.

If anyone is aware of any Windows programs (other than the command-line Pandoc) that can combine markdown files in this way, please post here. I’m now scared to write articles in Obsidian!


Have you tried Writemonkey? I’m thinking that might be a way to write multiple files in Markdown and combine them as a ‘project’. Haven’t tried it myself, but the writer says it’s possible.

I actually misread something which rendered the idea unfeasible. Simply exporting a file with the transcluded content replacing the placeholder should not be difficult at all. I’m sure this will be possible at some point.


Not possible right now, will be part of our Markdown export functionality.

Obviously after exporting to non-Obsidian flavor markdown, embed won’t auto-update any more, so please do that as a snapshot. We might add an HTML comment to indicate where the embed comes from, so that the connection doesn’t get lost.

If you’d like getting it tracked, please post a feature request.


This will be a great feature to have.


Can‘t agree more


+1. Being able to print/export as a pdf is essential.

Hi there,

I’ve been away a while…what is the current state of export? Can we export to Word with transclusions easily?

+1 here as well. Having transclution on export is critical for any serious writing of long manuscripts.


Ideally this can be implemented as export-to-markdown. The use case is that this can then be used in pandoc to produce docx, pptx, reveal.js, and other formats.

The export-to-pdf function already includes transclusions in the final PDF output. So this feature could be implemented by making the export-to-pdf functionality more configurable. Instead of exporting the generated markdown (with transclusions) into the Obsidian PDF converter this function could emit the markdown output to a file. It seems less work than what export-to-pdf is already doing.

Would be great to have this feature. It would make transclusion a very powerful feature.


+1 here for any kind of integration of the transcluded information into any kind of output, be it printing or md exporting. This would enable a lot of functionality for output generation.

Yes, please!

There actually is a way to do this now, but it’s certainly not intuitive. Here’s the procedure:

  1. Select a small bit of text at the top of the preview pane.
  2. Hold down your SHIFT key and then press your PAGE DOWN key multiple times until all of the text has been selected.
  3. Copy the selected text.
  4. Paste into Typora–or just paste into a new document in Obsidian.


Note that just pressing CTRL + A to select the preview text will not work. Neither will selecting a bit of text and then pressing SHIFT + CTRL + END.

Can’t we please just have the preview (the transcluded text) open in a new document rather than the preview pane? Or at least have that option? Or have the transcluded text included in an export other than PDF? Markdown!



That would be great for presentations!

Now it’s impossible to have embed files in a presentation, but if we can export it to a new markdown file, it’s possible to present this file.

This post appears as “resolved” but I haven’t see any explicit solution. I recently made another post which I believe are quite related (insert-paragraphs-for-docx-export. Basically I’m trying to have a completly functional workflow for using Obsidian for writing Scientific articles

Right now, I’m struggling (as you, I think) on composing a Outline/main note file that stores the content of other “atomic” notes at the same time that I keep the citation style.

When you use the core “Export to PDF” command you can get the content of embedded links ( “![[this is an embedded link]]”) but you cannot include formatted citations this way. I’ve tried Pandoc, and it solves the citation part, but then I can’t manage to include the content of my embedded notes!

Anyone knows of some work-around/plugin that could work?

I think that it was marked as resolved because OP should have made a Feature Request as Licat explained here

Yeah I would love a workaround to include transclusion in exports to docx. Pandoc does not recognize transclusion. Seems like converting pdf (exported from Obsidian) to docx is the closest we have.