excalidraw-workflow

Export Excalidraw diagrams to PNG and validate JSON rendering rules.

Updated Mar 25, 2026
One-click install
npx skills add https://github.com/zkzupup/MySkills --skill excalidraw-workflow
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: excalidraw-workflow
Source: https://github.com/zkzupup/MySkills/tree/main/skills/excalidraw-workflow
Command: npx skills add https://github.com/zkzupup/MySkills --skill excalidraw-workflow

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires puppeteer, and includes scripts (resource) components.

What problem does it solve?

Excalidraw diagrams often remain as editable JSON files, but sharing or publishing requires PNG exports and validation to prevent rendering defects. This skill exports diagrams to PNG using a bundled Node.js tool and enforces JSON correctness rules to ensure the exported image matches the source.

Core Features & Use Cases

  • PNG export pipeline: Batch export of .excalidraw files to PNG using a headless Chromium renderer with Excalidraw's exportToBlob API.
  • JSON correctness validation: Detects and prevents common rendering defects (misbound text, arrows through boxes, misaligned elements) by applying documented rules.
  • Batch workflows: Ideal for teams producing diagrams that must be published or documented with exact PNG references, while keeping the original .excalidraw as editable source.

Quick Start

Run the export script at scripts/export_excalidraw_png.js to export all .excalidraw files in your project to PNGs.

Frequently Asked Questions about excalidraw-workflow

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I batch export Excalidraw diagrams to PNG?

To batch export Excalidraw diagrams to PNG, run the bundled Node.js script to process all .excalidraw files in your project. The pipeline uses Puppeteer with headless Chromium and Excalidraw's exportToBlob API to generate PNG images from the editable JSON sources.

How do I validate Excalidraw JSON to prevent rendering defects?

To validate Excalidraw JSON and prevent rendering defects, apply strict correctness rules to detect misbound text, arrows through boxes, and misaligned elements. This validation ensures the exported PNG faithfully represents the editable source without visual errors.

Do I need Puppeteer to export Excalidraw files to PNG?

Yes, you need Puppeteer to export Excalidraw files to PNG because it provides the headless Chromium browser required to execute the Excalidraw exportToBlob API. This bundled Node.js pipeline ensures reliable rendering of the editable JSON source files.

What is the best way to publish Excalidraw diagrams as PNG images?

The best way to publish Excalidraw diagrams as PNG images is using a batch workflow that exports .excalidraw sources and validates the JSON. This approach guarantees the published PNGs match the editable source files while preventing rendering defects.

Why does my Excalidraw PNG export have misaligned elements and misbound text?

Your Excalidraw PNG export has misaligned elements and misbound text due to incorrect JSON structure. Applying documented JSON correctness rules during the export pipeline detects and prevents these common rendering defects before generating the final image.

Can I use headless Chrome for Excalidraw diagram validation in batch workflows?

Yes, you can use headless Chrome through Puppeteer for Excalidraw diagram validation in batch workflows. The Node.js export pipeline renders the JSON sources and applies correctness rules to ensure the output PNGs faithfully represent the editable diagrams.