This section documents Markdown written in a Web Device content item's content.md. The content reader turns it into an AUP tree, then the current document target renders it as page content. It is not the complete syntax reference for format: markdown in an AUP text primitive, and it is not a .web component catalog.
Each page places author-written source directly above its real result and says what that result proves and deliberately does not prove. The document itself is read-only. A component may retain an intrinsic limited interaction, such as switching a tab; that does not let a reader edit source, a manifest, a content item, or persistent data.
Verified Content Markdown structures
| What to write | Start here | Result boundary |
|---|---|---|
| YouTube, X/Twitter, or same-site content embed | Embed external and internal content | Only recognized provider URLs and validated same-site paths are supported; this is not an AUP session or bridge |
| A readable presentation with an inline player | Markdown slides | slides: true defines page boundaries; a named layout mounts the player. It does not provide a presenter view or free-form canvas |
| GFM tables and callouts | Tables and callouts | Presents static content; it does not establish editable tables or a data source |
| Navigation and explanatory cards | Markdown cards | A link performs ordinary navigation only; there is no exec, write, or editor permission |
| Numbered tutorials | Markdown steps | Presents a static step body; it does not execute a step's instructions |
Choose the layer first
For a reusable site layout section, start with .web/components and a page layout.aup. That path has its own manifest and renderer contract; a Markdown directive cannot replace it.
For a cross-device interactive AUP tree, start with an AUP app, a target renderer, and session semantics. Seeing one HTML result in a static document target does not verify events, patches, data binding, or another device.
For the exact boundary between these three layers, see Component resolution and AUP on Web Device.