comark-embed

中文文档
0.9.0发布于 2026/11/03MITTypeScriptES Module零依赖构建来源已验证

视频,音频和工具嵌入从一个链接:YouTube, Vimeo, Loom, Spotify, CodePen, StackBlitz, Figma和X,没有网络获取。一个Comark插件。

中文使用文档

comark-embed

npm version npm downloads license docs

视频,音频和实时代码从一个链接:YouTube, Vimeo, Loom, Spotify, CodePen, StackBlitz, Figma,和X播放器,从链接单独读取,没有网络获取。一个 Comark HTML, Vue, React和Svelte插件。

pnpm add comark comark-embed
import { createHtmlRenderer } from "@comark/html";
import embed, { components } from "comark-embed/html";

const render = createHtmlRenderer({ plugins: [embed()], components });
::embed{url="https://youtu.be/KCrXgy8qtjM" title="Watch before standup: Vite in 100 Seconds" start=30}
::

::embed{url="https://comark.dev" title="Comark docs, for the duck report"}
::

url 一定是。 https:// 链接。 title 命名播放器和它下面的链接的文本,这使页面在打印,提要阅读器和iframe被阻止的地方可读。 start 是YouTube或Vimeo视频的几秒钟。用 :: 下一行。

提供者链接上面写着
YouTubeyoutube.com/watch?v=, youtu.be/, /shorts/, /embed/, /live/;戏剧从 youtube-nocookie.com
Vimeovimeo.com/<number>,未列出的链接及其散列;玩 dnt=1
织机loom.com/share/<id>, /embed/<id>
Spotifyopen.spotify.com/ 曲目,专辑,播放列表,剧集,节目和艺术家
CodePencodepen.io/<user>/pen/<id> (也 full, details,或 embed)
StackBlitzstackblitz.com/edit/<project>, stackblitz.com/github/<owner>/<repo>[/<path>]
Figmafigma.com/design, file, proto, board, slides, deck
Xx.com/<user>/status/<id>, twitter.com, mobile. 链接;长到柱子的高度

任何其他 https:// 链接呈现为带有其 title 和主机。卡片还不能获取页面标题,所以给每个卡片一个 title。

插件增加了每一个问题 meta.issues,因此主机可以在发布文档之前拒绝该文档。一个 url 这不是 https:// 呈现。

渲染器

渲染器进口
@comark/htmlcomark-embed/html:样式是内联的
@comark/vuecomark-embed/vue
@comark/reactcomark-embed/react
@comark/sveltecomark-embed/svelte

每个条目将解析插件导出为 default 还有渲染器 components. Vue、React和Svelte组件在挂载时添加样式;进口 comark-embed/style.css 使用您的样式,使服务器呈现的页面不会移位。

样式遵循shadcn/ui:它们读取它的CSS变量,例如 --background 和 --border,否则使用它的中性主题。设置共享 --comark-* 令牌主题每个插件一次;规则放在 comark CSS层,所以任何简单的规则你自己的胜利。覆盖 --ce-app-height 改变CodePen, StackBlitz和Figma的高度;见嵌入 主题页面。

版本与发布记录

comark-embed 共发布 11 个版本,首次发布于 2026/10/21;过去 12 个月发布了 11 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.9.0latest2026/11/03今天
0.8.22026/11/021 天前
0.8.12026/11/011 天前
0.8.02026/10/312 天前
0.7.62026/10/313 天前
0.7.52026/10/303 天前

关于 comark-embed 的常见问题

comark-embed 是什么?

视频,音频和工具嵌入从一个链接:YouTube, Vimeo, Loom, Spotify, CodePen, StackBlitz, Figma和X,没有网络获取。一个Comark插件。

如何安装 comark-embed?

在项目目录运行 npm install comark-embed,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:comark(^0.8.0)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

comark-embed 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

comark-embed 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

comark-embed 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=22.12.0。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

comark-embed 可以商用吗?

comark-embed 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

comark-embed 还在维护吗?

最新版本 0.9.0 发布于 2026/11/03(今天);至今共发布 11 个版本,其中过去 12 个月发布了 11 个;首次发布于 2026/10/21。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。