OpenKnowledge
Components

Mirror

Render a read-only copy of a `<MirrorSource>` block from another doc. Use to keep the same content in sync across multiple docs without copy-paste — edits land at the source, every Mirror reflects the change

Example

Preview
Mirror of specs/architecture → #overview-diagram — read-only

This body renders live from wherever the <MirrorSource name="overview-diagram"> with a matching name lives — edits there ripple here without a copy step.

```mdx
<Mirror src="specs/architecture" name="overview-diagram" />
```

Props

Prop

Type

Also: <MirrorSource>

Mark a block as the source of truth for content that appears in multiple docs. Wrap any block content; <Mirror src="…" name="…"> references render this verbatim read-only at every call-site. Edit here, propagate everywhere.

Preview
source name=overview-diagram

The canonical content this block owns. Every <Mirror> that references this name anywhere in the project reads from here.

<MirrorSource name="overview-diagram">
  Authoritative content lives inside this block — edits here propagate to every `<Mirror>` that references this name.
</MirrorSource>

Prop

Type

Also matches: mirror, sync, synced, transclude, embed, reference, shared block

Author it

Type /mirror in the editor to insert it from the slash menu, or write the tag directly in source mode. The Properties panel on the right of the editor exposes every prop above as a form field once the block is selected.

A Mirror Source inserted from the slash menu takes its name from the nearest heading above it, as a slug of at most 40 characters cut at a word: ## Pricing Plans gives pricing-plans. With no heading above it the name is source, and -1, -2 and so on are added when another Mirror Source in the doc already has that name. In a Mirror's Properties panel, src suggests documents and name suggests the Mirror Source names in the chosen document.

On this page

Product updates