openpencil/packages/docs/programmable/cli/exporting.md
2026-03-28 15:42:21 +03:00

62 lines
1.6 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

---
title: Exporting
description: Export document content to PNG, JPG, WEBP, SVG, `.fig`, or JSX, and convert between document formats.
---
# Exporting
Export designs from the terminal — raster images, vectors, `.fig` subsets, or JSX code.
## Image Export
```sh
open-pencil export design.fig # PNG (default)
open-pencil export design.fig -f jpg -s 2 -q 90 # JPG at 2×, quality 90
open-pencil export design.fig -f webp -s 3 # WEBP at 3×
open-pencil export design.fig -f svg # SVG vector
open-pencil export design.fig -f fig --page "Page 1" # export one page as .fig
open-pencil export design.fig -f fig --node 1:23 # export one node as .fig
```
Options:
- `-f` — format: `png`, `jpg`, `webp`, `svg`, `jsx`
- `-s` — scale: `1``4`
- `-q` — quality: `0``100` (JPG/WEBP only)
- `-o` — output path
- `--page` — page name
- `--node` — specific node ID
## JSX Export
Export as JSX with Tailwind utility classes:
```sh
open-pencil export design.fig -f jsx --style tailwind
```
Output:
```html
<div className="flex flex-col gap-4 p-6 bg-white rounded-xl">
<p className="text-2xl font-bold text-[#1D1B20]">Card Title</p>
<p className="text-sm text-[#49454F]">Description text</p>
</div>
```
Also supports `--style openpencil` for the native JSX format (see [JSX Renderer](../jsx-renderer)).
## Thumbnails
```sh
open-pencil export design.fig --thumbnail --width 1920 --height 1080
```
## Live App Mode
Omit the file to export from the running app:
```sh
open-pencil export -f png # screenshot the current canvas
```