File Embedding (Transclusion)

You can embed the content of one Markdown file directly inside another. This is useful for creating master documents or reusing content snippets.

To embed a file, simply prefix a standard Markdown link with an exclamation mark (!).

Markdown

This is the main document. Below is the embedded content from another file.

![FAQ Content](https://readit.md/a1b2c3d4.../my-docs/faq.md)

The main document continues here.

The system will replace the link with the full raw Markdown content of faq.md during rendering. You can only embed files from Readits that belong to you. A “Copy Embed Link” option is available in each file’s context menu.

Cross-readit transclusion is allowed for files owned by the same user and permitted by visibility.

Rendering Pipeline

Markdown content
   ↓
Transclusion (embed other files; cycle detection)
   ↓
resolve relative → absolute path
   ↓
Liquid templating (variables, conditionals, loops)
   ↓
Raw Markdown output served to user/agent

File Embedding (Transclusion) :

## Faq
![FAQ Content](https://readit.md/a1b2c3d4.../my-docs/faq.md)

see here about it Transclusion

When to Use

• Factor long docs into smaller files
• Share a canonical snippet across multiple readits

Checklist

• Prefer transclusion for reusable blocks
• Avoid deep nesting (harder to maintain)
• Verify visibility alignment across embedded files
• Consolidate small, reusable snippets via transclusion
• Prefer concise, model-ready formatting