pptx-presentation-to-markdown

Parse PPTX (PowerPoint) presentations to markdown or text. Powered by LlamaParse v2. Zero dependencies, Node 18+.

Handles .pptx and .ppt files out of the box — plus .odp, .key, PDF, and image formats with OCR.

Install

npm install pptx-presentation-to-markdown

Quick Start

Set your API key:

export LLAMA_CLOUD_API_KEY=llx-...

Parse a presentation:

import { parse } from "pptx-presentation-to-markdown";

const result = await parse("./presentation.pptx");
console.log(result.markdown);

Advanced Usage

import { pptx-presentation-to-markdown } from "pptx-presentation-to-markdown";

const parser = new pptx-presentation-to-markdown({ apiKey: "llx-..." });

// Parse a presentation with options
const result = await parser.parse("./slides.pptx", {
  tier: "agentic",
  processing_options: { language: "fr" },
});

// Parse a buffer (e.g. from an upload)
const buffer = fs.readFileSync("./deck.pptx");
const result = await parser.parse(buffer, {
  fileName: "deck.pptx",
});

Supported Formats

| Extension | Format | |-----------|--------| | .pptx | Microsoft PowerPoint (OpenXML) | | .ppt | Microsoft PowerPoint (Legacy) | | .odp | OpenDocument Presentation | | .key | Apple Keynote | | .pdf | PDF | | .png / .jpg / .tiff / .bmp / .webp / .gif | Images (OCR) |

API

parse(input, options?)

Uploads a presentation, waits for parsing to complete, and returns the result.

Input: file path (string) or file contents (Buffer | Uint8Array)

Options:

| Option | Type | Default | Description | |--------|------|---------|-------------| | tier | string | "fast" | Parsing tier: fast, cost_effective, agentic, agentic_plus | | version | string | "latest" | API version | | apiKey | string | env var | Override API key | | expand | string[] | ["markdown_full", "text_full"] | Fields to expand | | pollIntervalMs | number | 1000 | Polling interval in ms | | timeoutMs | number | 300000 | Max wait time in ms | | fileName | string | "presentation.pptx" | Filename hint for buffer input | | mimeType | string | auto-detected | MIME type for buffer input | | signal | AbortSignal | — | Cancellation signal | | processing_options | object | — | LlamaParse processing options (language, disable_ocr, etc.) | | agentic_options | object | — | Agentic options (custom_prompt) | | page_ranges | object | — | Page range options (max_pages, target_pages) | | disable_cache | boolean | — | Disable document caching |

Returns: ParseResult

interface ParseResult {
  markdown: string;     // Full markdown output
  text: string;         // Full text output
  job: JobResponse;     // Job metadata (id, status, etc.)
  _raw: object;         // Raw API response
}

new pptx-presentation-to-markdown(config?)

Create an instance with explicit configuration.

| Option | Type | Default | Description | |--------|------|---------|-------------| | apiKey | string | LLAMA_CLOUD_API_KEY | API key | | baseUrl | string | https://api.cloud.llamaindex.ai | API base URL |

License

MIT