URL 嵌入

docmd 原生集成了经过高度优化的 embed-lite 解析器。它会自动将外部 URL 转换为安全、零延迟的 UI 组件。

容器语法 (Container Syntax)

::: embed [url:"https://domain.com/resource"] # URL 嵌入容器开启

功能特性与支持属性 (Features & Attributes)

参数 / 属性 类型 描述
资源 URL "String" | url:"..." 要嵌入的媒体/资源的绝对 URL(第 1 位置参数或 url:"...")。
支持的网络 内置集成 自动识别 YouTube、Vimeo、TikTok、X、Figma、Gists、CodePen、Spotify 等。
回退按钮 自动触发 未识别的 URL 将安全地渲染为格式化的超链接按钮,不会引发错误。

示例

视频嵌入

粘贴任何 YouTube、Vimeo 或 TikTok URL 即可呈现原生、响应式的播放器。

::: embed url:"https://www.youtube.com/watch?v=0CSyIBHQy9g"

回退行为

如果解析器遇到不受支持或无效的 URL,docmd 会优雅地回退为超链接按钮,而不会破坏页面。

::: embed url:"https://docs.docmd.io/content/containers/embed/"