gabrielmoreira pptx-to-md
Convert PowerPoint (.pptx) to Markdown via Pandoc.
When to Use
- Extracting slide content for editing in plain text
- Migrating decks into documentation systems
- Salvaging content from legacy
.pptxfiles
What's Here
pptx-to-md.cjs — Node script that wraps Pandoc.
External Dependencies
node(≥ 16)pandoc(≥ 3.0) on PATH
Usage
node pptx-to-md.cjs deck.pptx
node pptx-to-md.cjs deck.pptx --output deck.md
node pptx-to-md.cjs deck.pptx --extract-media ./media
Output Structure
| PowerPoint | Markdown |
|---|---|
| Each slide | ## Slide N heading |
| Title placeholder | First line under heading |
| Body text / bullets | Paragraphs and lists |
| Speaker notes | Quoted block at slide end |
| Embedded images | Saved to --extract-media dir, referenced as ![]() |
Notes
- Animations, transitions, and complex layouts are lost — content survives, motion does not
- Pair with
md-to-pptxfor round-trip workflows (lossy for layouts, lossless for content) - Use
--extract-mediato keep images as separate files instead of inlining