Renderer
Renderers transform a content target into plugin-specific HTML; return null when the target is not handled so another renderer can participate. Examples include Canvas, Excalidraw, and attachment rendering.
Renderer contract
Renderers receive a target with kind, path, raw, label, url, embed plus standard PluginContext. Return null when the renderer does not handle the target so the next renderer is tried.
Renderer type
PluginContentRenderer type defines the renderer contract:
type PluginContentRenderer = {
kind: string;
handle(
target: { kind: string; path: string; raw: string; label: string; url: string; embed?: string },
context: PluginContext,
): string | null;
};Each renderer declares its kind string (e.g., "canvas", "excalidraw", "attachment", "media"). The framework matches targets to renderers by kind, and plugins can register multiple renderers for different content kinds.
Examples
Built-in renderers include: canvas (Excalidraw), attachment, and media. Custom renderers can be defined per plugin for formats such as Bases or third-party diagram libraries.