Referencia
Exportación
La app, el MCP y la CLI usan el mismo exportador, así que el resultado es igual desde cualquiera de los tres.
Formatos
| Formato | Varios elementos | Alta | Media | Baja |
|---|---|---|---|---|
| Un PDF, una página por elemento | Imagen sin pérdida | Imágenes JPEG 85 | JPEG 70 a escala 1 | |
| PNG | Un .zip con un archivo por elemento | Sin pérdida | Paleta de 256 colores | Paleta de 64 colores |
| JPEG | Un .zip | Calidad 92 | Calidad 80 | Calidad 65 |
| WEBP | Un .zip | Calidad 100 | Calidad 80 | Calidad 60 |
| SVG | Un archivo con todos | Vectorial | — | — |
| HTML | Un archivo con todos | HTML + CSS | — | — |
La escala (scale, de 1 a 4, por defecto 2) es independiente de la calidad (quality: high, medium o low; por defecto high).
Ejemplos
canvappen export deck.pen --format pdf
canvappen export deck.pen --format pdf --ids c3,a1,b2
canvappen export design.pen --format png --ids home --scale 3{ "path": "~/proyecto/deck.pen", "format": "pdf", "quality": "medium" }Orden de las páginas
- Con
ids, se respeta el orden en que los pasas. - Sin
ids, se exporta todo el documento en orden de lectura del canvas: filas de arriba hacia abajo y, en cada fila, de izquierda a derecha.
Carpeta y nombres
Por defecto los archivos se guardan junto al .pen, en exports/<nombre-del-pen>/, y se sobrescriben al volver a exportar.
| Qué exportas | Nombre del archivo |
|---|---|
| El documento completo o varios elementos | <nombre-del-pen>.<ext> |
| Un solo elemento | <nombre-del-elemento>.<ext> |
| Varios elementos en PNG, JPEG o WEBP | <nombre-del-pen>-<formato>.zip |
Los nombres van en minúsculas, sin acentos y con guiones: «07 — App pasajero · El viaje» queda como 07-app-pasajero-el-viaje. Con out eliges otra ruta; si el archivo ya existe hace falta overwrite, y la extensión debe coincidir con el formato.
Modo estricto
Con strict (o "strict": true en config.json, o CANVAPPEN_STRICT=1), export no escribe el archivo si falta algo. preview devuelve la imagen igual y marca la respuesta como error.
| Campo de la respuesta | Qué indica |
|---|---|
missingFonts | Fuentes sustituidas por Inter |
missingImages | Imágenes que no cargan |
missingIcons | Iconos que no existen |
brokenLibraries | Componentes de librerías que faltan |
scriptErrors | Errores de scripts |
Documentos grandes
Al exportar muchas páginas, canvappen reutiliza una sola superficie de dibujo, así la memoria no crece con la cantidad de páginas. En WEBP, las páginas de más de 4,2 MP se exportan a menor escala y la respuesta lo indica en notes.