Kalka
文档

导出

导出 HTML 和 CSS,复制 JSX 和 Tailwind,保存设计令牌,导出 PNG、JPG、WebP、SVG、PDF 和 PowerPoint,可在应用中或命令行中完成。

docs / export

在 Kalka 中,设计本身就是 HTML 和 CSS,所以导出不需要任何转换:它直接写出画布上显示的内容。图片和 PDF 由与画布相同的浏览器引擎绘制。

图层的导出设置

选中一个图层,或者不选任何内容以导出整个页面,然后在设计面板的 导出 部分点击 添加导出。每个导出设置都有一种格式,图片还可以设置缩放倍数,比如 2x。添加多个设置,就能一次导出多个文件。

格式 你会得到
PNG、JPG、WebP 按所选倍数生成的图片
SVG 矢量图形
PDF PDF 文档
PPTX PowerPoint 文件
HTML 带样式表和图片的页面,打包为 .zip,或为内嵌图片的单个文件
选中一张卡片时的设计面板:填充、描边、效果、HTML 标签和类名,以及 1x PNG 的导出设置
带有导出设置的图层。它的 HTML 部分显示类名和它自己保留的值。

打开预览,可以在导出前查看结果。文件 › 导出所选内容…(Shift Cmd E,Ctrl Shift E)直接导出所选内容,也可以将其保存为 .fig。

HTML 与 CSS

导出的 HTML 读起来就像人写的代码:元素使用真实的标签,重复的样式归入类,断点写成 @media 规则,变量写成 CSS 自定义属性,图片保存为文件。Kalka 自己的属性不会被写入。

如果你把文档保存为 Kalka 文件夹,可能根本不需要导出:文件夹里已经有每个页面对应的 HTML、styles.css、你的令牌和图片。参见文件与版本。

复制为代码

右键点击一个图层,打开 复制/粘贴为:

  • 复制为 JSX,用于 React;
  • 复制为 SVG;
  • 复制为 PNG;
  • 复制为文本。

代码 面板会以 HTML/CSS、Design JSX 或 Tailwind JSX 显示所选内容,可直接复制。参见画布与图层。

设计令牌

在变量页面中:

  • 导出为设计令牌 保存一个 W3C 设计令牌的 .zip,每个集合模式一个文件;
  • 将所有变量复制为 CSS 复制自定义属性;
  • 将所有变量复制为 Tailwind 主题 复制一个用于 Tailwind CSS v4 的 @theme 代码块。

Figma

使用 另存为… 并选择 .fig 类型,会写出一个可以在 Figma 中打开的文件。对于 Figma 无法显示的内容,比如类规则、断点和着色器,Kalka 会提醒你。

从命令行导出

kalka 命令无需打开应用即可从文件导出。请在 Kalka 仓库的克隆中运行(参见 MCP 与 ACP):

# A JPG at 2x
bun kalka export design.fig -f jpg -s 2

# One HTML file, images embedded
bun kalka export design.fig -f html --html standalone --assets inline

# Tailwind JSX
bun kalka export design.fig -f jsx --style tailwind

# Storybook stories for Vue, re-exported on every save
bun kalka export design.fig -f storybook --framework vue -o src/stories --watch

# The document's variables as CSS custom properties
bun kalka tokens design.fig --format css > tokens.css

省略文件时,kalka export -f png 会导出已打开应用中的所选内容。

Storybook 导出会为每个组件写一个 story 文件,支持 React、Vue 或纯 HTML,并为每个变体提供控件。