Node.js
Read local files, uploads, S3/R2 objects, and other byte sources.
XLS to Markdown in your browser.
Convert XLS files to GitHub-Flavored Markdown directly in your browser.
Your XLS stays on your device. No upload. No account.
- npm @mdgate/xlsx
- license MIT
- runtime Node.js · Edge · browser
Starting local converter
Use XLS to Markdown in your app
$
npm install @mdgate/xlsx
import { toMarkdown } from '@mdgate/xlsx';
const markdown = await toMarkdown(bytes);Pure TypeScript, Node.js, Cloudflare Workers, Edge, Browser, No Python, No native addons, No WASM, Zero third-party runtime dependencies
How XLS to Markdown works
- XLS
- workbook parsing
- sheets · cells · tables
- GitHub-Flavored Markdown
Built for JavaScript runtimes
Cloudflare Workers
Parse Excel workbooks directly inside Workers without Excel or a native binary.
Browser
Convert XLS locally without uploading it to a server.
Edge
Run the same TypeScript converter in compatible Edge runtimes.
What @mdgate/xlsx extracts
- One Markdown section per sheet
- GitHub-Flavored Markdown tables
- Merged cells
- Header-row detection
- Number formats (dates, percents, currency-style text)
- Shared strings and typed cell values
- Encrypted workbook detection
Why @mdgate/xlsx
Runs where your JavaScript runs
No separate processing service. The converter is TypeScript you can call from Node.js, Cloudflare Workers, Edge runtimes, and browsers.
Local conversion
XLS files can stay inside your application or browser.
Content detection
Recognizes XLS files from their contents, not only the filename.
Deterministic parsing
The same XLS file produces repeatable Markdown without model inference.
Small runtime surface
No Python. No native addons. No WASM. No third-party runtime dependencies.
XLS for AI agents
Turn XLS files into content your agent can actually work with.
- XLS
- Markdown
-
- grep
- search
- chunk
- index
- cache
- cite
- reason
Need more than XLS?
One format
@mdgate/xlsx
Your own set
@mdgate/core
+ @mdgate/xlsx
+ @mdgate/pdf
+ @mdgate/docx
Broad file support
@mdgate/converters
FAQ
Can I convert XLS to Markdown without uploading it?
Yes. XLS files can be converted locally in the browser.
Does XLS to Markdown work in Cloudflare Workers?
Yes. @mdgate/xlsx runs directly in Cloudflare Workers.
Does it require Python?
No.
Does it require native addons or WASM?
No.
What does it output?
GitHub-Flavored Markdown.
Can I install only the XLS converter?
Yes. Install @mdgate/xlsx instead of the complete converter set.
Does this convert CSV?
No. Use @mdgate/csv for .csv and .tsv.