Wiki Artifact Embeds
Global wiki markdown directive for rendering important links as source artifacts instead of plain prose links.
The wiki viewer supports ::artifact{...} on any page. It renders a themed, light/dark-safe card for source-critical links: articles, docs, GitHub repos, videos, PDFs, demos, datasets, images, tools, and X-status artifacts. Normal inline links and citations remain links; artifacts are for links the reader should inspect as evidence or product UI. Source: User request, 2026-06-24
Routing Summary
Use ::artifact during Capture Ingest Protocol, x-bookmark-absorb, and any wiki page where a source-critical link should be visible as an artifact. Pair with React Tweet for original X posts and use plain links only for incidental citations.
Syntax
::artifact{ url="https://takumi.kane.tw/docs/upgrade/v2" title="Takumi v2 Upgrade Docs" kind="docs" description="Rust JSX-to-image renderer upgrade notes." }
Optional fields: title, kind, description, image, site, display, and variant="compact". If kind is omitted, the renderer infers common types from the URL: GitHub repos, YouTube videos, PDFs, images, X statuses, docs, and articles.
Use variant="compact" inside ledgers or dense source lists:
::artifact{ url="https://github.com/vercel/react-tweet" title="vercel/react-tweet" kind="repo" variant="compact" }
Use ::tweet{...} when the original X post itself should render as a tweet card. Use ::artifact{...} for linked docs, repos, demos, videos, and articles discovered through that post.
Live Example
Authoring Rule
When a wiki page has a source-critical external link, render it as an artifact card unless it is only a citation chip or incidental inline reference. This keeps evidence inspectable and makes linked products/tools feel like actual artifacts, not footnotes.
Timeline
- 2026-06-24 | Added global artifact cards to the wiki renderer and source-compile/x-bookmark authoring rules. Source: User request, 2026-06-24