dot-pages-document-parser

dot-pages-document-parser

Parse Apple Pages files to markdown or text. Powered by LlamaParse v2. Zero dependencies, Node 18+.

Handles .pages files out of the box — plus PDF, DOCX, PPTX, XLSX, and other common formats.

Install

npm install dot-pages-document-parser

Quick Start

Set your API key:

export LLAMA_CLOUD_API_KEY=llx-...

Parse a Pages file:

import { parse } from "dot-pages-document-parser";

const result = await parse("./document.pages");
console.log(result.markdown);

Advanced Usage

import { dot-pages-document-parser } from "dot-pages-document-parser";

const parser = new dot-pages-document-parser({ apiKey: "llx-..." });

// Parse a Pages file with options
const result = await parser.parse("./report.pages", {
  tier: "agentic",
  processing_options: { language: "fr" },
});

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

Supported Formats

Extension	Format
.pages	Apple Pages
.pdf	PDF
.docx / .doc	Microsoft Word
.pptx / .ppt	Microsoft PowerPoint
.xlsx / .xls	Microsoft Excel
.html	HTML
.csv	CSV
.txt	Plain text
.png / .jpg / .tiff / .bmp / .webp / .gif	Images (OCR)

API

parse(input, options?)

Uploads a document, 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	"document.pages"	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 dot-pages-document-parser(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