Marp to Editable PPTX

Export your Marp Markdown presentations to truly editable PowerPoint files — no LibreOffice, no extra software.

Each text box, image, and shape is placed as an individual native PowerPoint object, so you can freely move, resize, and restyle content in PowerPoint after export.

Why this extension?

The official Marp toolchain offers two PPTX export modes, both with limitations:

The LibreOffice-based export works by converting the slide to a PDF and then importing it into PowerPoint via LibreOffice. This results in cluttered, hard-to-edit objects. More importantly, many enterprise users cannot install LibreOffice due to IT policies.

This extension uses a different approach: it reads the browser-rendered DOM directly, extracting the exact position, font, color, and content of every element, and builds a native PPTX from scratch.

Layout faithfulness note: Text may look slightly different or wrap at a different point in PowerPoint than in the browser. This happens because browsers and PowerPoint use separate text rendering engines with different character spacing and line-break calculations — even with the same font. The effect is strongest when a Marp theme uses web fonts (e.g. from Google Fonts): PowerPoint substitutes a system font, changing character widths enough to shift a line break and cascade every element below it. Using system fonts in your theme reduces the risk, but a pixel-perfect match is not guaranteed.

Requirements

• Google Chrome or Microsoft Edge — that's it. No LibreOffice, no extra runtime.

Quick Start

1. Open a Marp Markdown file (.md) in VS Code
2. Press F1 and run Marp: Export to Editable PPTX
3. Choose a save location in the dialog
4. Open the generated .pptx in PowerPoint — every element is editable

Slide Quality

Each image shows Marp HTML on the left and the exported PPTX on the right.
All slides are from the fixture deck src/native-pptx/test-fixtures/pptx-export.md and are automatically updated by CI on every release.

⬇ Download sample PPTX — the latest generated file, updated automatically on every release.

All slide comparisons

How it works

1. Converts your Markdown to HTML using @marp-team/marp-cli
2. Launches a headless Chrome/Edge to render each slide at full resolution
3. Extracts every element's exact position, font, color, and content via getComputedStyle() and getBoundingClientRect()
4. Assembles an editable .pptx where each element is a native PowerPoint shape

Because it reads the browser's computed layout — not the Markdown source or CSS — it works correctly with any Marp theme, custom CSS, and html: true content. Element positions, sizes, colors, and images are reproduced faithfully; see the Layout faithfulness note above for the known typographic limitation.

For contributors

See CONTRIBUTING.md for setup, the fix workflow (ADR log, fixture slides, visual comparison), commit style, and PR rules.

AI-assisted development

This repository ships with GitHub Copilot customizations:

• Skill — .github/skills/marp-pptx-visual-diff/SKILL.md: step-by-step guide for the visual fidelity improvement loop
• Instructions — .github/instructions/marp-editable-pptx.instructions.md: coding conventions, architecture rules, and degression-prevention checklist

Architecture & decisions

src/native-pptx/README.md contains the full architecture description and an ADR (Architecture Decision Record) log that documents every significant design decision and past bug fix.

License

MIT