SuperAPI AI 工具集

canvas-export

办公与效率

查看项目

更新于 10-16 04:58

技能介绍

用途:将 Obsidian Canvas 文件导出为 PNG、SVG 或 PDF。

主要能力与优先级:

  1. Advanced Canvas 插件导出(首选):需 Obsidian 运行且已安装 Advanced Canvas,支持 PNG 与带透明度的 SVG。操作方式为在 Obsidian 中右键画布背景 → Advanced Canvas → Export as PNG/SVG,或使用命令面板 Advanced Canvas: Export as PNG。导出文件出现在画布目录,质量最高,使用 Obsidian 自身渲染引擎。
  2. Playwright 截图(回退):当 Obsidian 未运行或未安装 Advanced Canvas 时使用。需安装 Playwright:pip install playwright && playwright install chromium。先检查可用性:python3 -c "from playwright.sync_api import sync_playwright; print('ok')" 2>/dev/null && echo "available" || echo "not available"。可用时由画布 JSON 生成独立 HTML 预览并截图,报告输出路径与尺寸。
  3. 用户协助截图(最后手段):提示用户在 Obsidian 中打开画布、缩放至适应全部内容后截图;Linux(COSMIC)建议 Print 键,macOS 建议 Cmd+Shift+4。

操作命令:/canvas export png [output_path]、/canvas export svg [output_path]、/canvas export pdf [output_path]。默认目标为当前画布或 main.canvas;未指定输出路径时写入 [canvas_dir]/exports/[canvas-name].png。PDF 导出对标准画布先导出 PNG 再用 ImageMagick 转换:convert [png] [pdf];对演示型画布(存在边连接的幻灯片分组)逐组导出 PNG 后合并为多页 PDF:convert slide-1.png slide-2.png slide-3.png output.pdf。

输出目录约定:默认 [canvas_dir]/exports/,Vault 模式为 wiki/canvases/exports/,独立模式为 .canvases/exports/,目录不存在时创建。

限制:Playwright 渲染为近似效果,无法完全复现 Obsidian 画布渲染器;Playwright 不支持原生 SVG 导出,会回退为 PNG;PDF 导出依赖 ImageMagick 的 convert 命令;文本节点中的 Mermaid 图在 Playwright 截图中可能无法渲染(需 Mermaid JS 库);GIF 动画在截图中仅捕获静态帧;导出质量取决于所用方法(Advanced Canvas > Playwright > 手动截图)。