excalidraw-convert

Convert Excalidraw diagrams to editable PowerPoint vector objects or Lucid Package Format (.lucid).

Features

PowerPoint output

Each shape, arrow, and text box becomes a native PowerPoint object you can move, resize, recolour, and animate individually — not a flat image.

Lucid output

Produces a .lucid file (ZIP archive in Lucid Package Format) that can be opened directly in LucidChart or LucidSpark.

Styling carried over (both formats)

Fill colour, stroke colour, stroke width, dashed/dotted strokes, rounded corners, arrowhead types, opacity, background colour, multi-line text, font family, font size, and text alignment.

Installation

pip install excalidraw-convert

For SVG image support in PowerPoint output (optional):

pip install "excalidraw-convert[svg]"

To install from source:

pip install -e ".[dev]"

Usage

Command line

# Convert to PowerPoint
excalidraw-convert convert "https://excalidraw.com/#json=<id>,<key>" -o output.pptx

# Convert to Lucid Package Format
excalidraw-convert convert-lucid "https://excalidraw.com/#json=<id>,<key>" -o output.lucid

# From a direct JSON / .excalidraw file URL
excalidraw-convert convert "https://raw.githubusercontent.com/you/repo/main/diagram.excalidraw" -o output.pptx

# Append slides to an existing presentation
excalidraw-convert convert "https://..." -o existing.pptx --embed

# Inspect a scene before converting
excalidraw-convert inspect "https://..."

Also callable as a module:

python -m excalidraw_convert convert "https://..." -o output.pptx
python -m excalidraw_convert convert-lucid "https://..." -o output.lucid

Python API

from excalidraw_convert import fetch_scene, convert, convert_to_lucid

scene = fetch_scene("https://excalidraw.com/#json=<id>,<key>")

# PowerPoint
convert(scene, "output.pptx")

# Lucid Package Format
convert_to_lucid(scene, "output.lucid")

# Append to an existing PowerPoint file
convert(scene, "existing.pptx", embed_path="existing.pptx")

# Custom slide dimensions (inches, new files only)
convert(scene, "output.pptx", slide_width=10, slide_height=7.5)

Supported URL formats

Note on Excalidraw share links: the scene is end-to-end encrypted in the browser. This tool replicates the AES-GCM decryption that the Excalidraw web app performs client-side. If decryption fails for a link, try exporting the scene as a .excalidraw file and hosting it somewhere accessible.

Limitations / known gaps

Both formats

• Roughness / hand-drawn style: Excalidraw's sketchy aesthetic is not reproduced — shapes are rendered as clean geometric shapes.
• Hachure fill: approximated as a solid fill.
• Curved / elbow arrows: rendered as straight connectors or straight segments.
• freedraw pressures: variable stroke-width pressure data is ignored; a fixed width is used.
• Grouped elements: group membership is preserved in rendering order but not as native groups.
• Embeddable / iframe elements: skipped with a warning.
• Fonts: Excalidraw's Virgil hand-drawn font is mapped to Caveat (install it for best results; falls back to the system default).

PowerPoint only

• freedraw elements are rendered as freeform polygon paths (not true brush strokes).

Lucid only

• freedraw elements are approximated as flexiblePolygon shapes with up to 100 sampled vertices.
• Arrow connection points snap to the nearest edge of the target shape.

Development

pip install -e ".[dev]"
pytest tests/ -v