Extends
| id The block's permanent identity inside its document. | inherited | |||||||||||||
| revision Output only: CID of the last Change that modified this block. | optional · inherited | |||||||||||||
| type Block type tag, always `Embed`. | Embed | optional | ||||||||||||
| link The embedded resource — an `hm://` URL, optionally pinned to a version, block or text range. | ||||||||||||||
| attributes Embed settings and parent-layout attributes. | optional | |||||||||||||
other fields: | ||||||||||||||
An embed block shows another Hypermedia resource in place. link is required and is an hm:// URL. It may pin a version with ?v=, follow the latest with &l, and narrow the target to a block (#id), a block with its children (#id+) or a text range (#id[start:end]); see URLs. The view attribute is an embed view: Content, Card, Comments or Link. A block comment is a comment whose body starts with an Embed of the quoted block. Renderers detect cycles and fall back to a link.
Opening an embed
In desktop and web readers, including mobile web, clicking a document block embed opens its document if needed and scrolls to the referenced block. This also applies to document embeds inside comments. Clicking the same reference again scrolls to the block again, even when the URL has not changed. If the referenced block no longer exists in the latest version, the reader opens the newest version that still contains it, or the version the embed pins.
A document embed without a block reference opens the document if needed. If that document is already open, the reader keeps its current scroll position.
A comment embed opens the target document and its comment thread, then reveals, scrolls to, and highlights the exact comment or reply. Clicking it again repeats the scroll. A comment fragment also retains its pinned comment version and text selection.
If the target is missing after loading, the reader shows “Block not found” or “Comment not found”. It opens the target document if needed and preserves the reading position when that document is already open.
See also
block/embed-view: the four ways an embed renders.
URLs: block references, text ranges and versions.
block/web-embed and block/nostr: embeds of outside content.
block/query: a live list of documents.
Blocks: the block model.
Do you like what you are reading? Subscribe to receive updates.
Unsubscribe anytime