rtf-file-parser

Parse RTF (Rich Text Format) files to markdown or text. Powered by LlamaParse v2. Zero dependencies, Node 18+.

Handles .rtf files out of the box — plus PDF, DOCX, HTML, and other common document formats.

Install

npm install rtf-file-parser

Quick Start

Set your API key:rtf-file-parser

export LLAMA_CLOUD_API_KEY=llx-...

Parse an RTF file:

import { parse } from "rtf-file-parser";

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

Advanced Usage

import { rtf-file-parser } from "rtf-file-parser";

const parser = new rtf-file-parser({ apiKey: "llx-..." });

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

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

Supported Formats

| Extension | Format | |-----------|--------| | .rtf | Rich Text Format | | .pdf | PDF | | .docx / .doc | Microsoft Word | | .html | HTML | | .txt | Plain text |

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.rtf" | 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 rtf-file-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