Node.js
Read local files, uploads, S3/R2 objects, and other byte sources.
Numbers to Markdown in your browser.
Convert Numbers files to GitHub-Flavored Markdown directly in your browser.
Your Numbers stays on your device. No upload. No account.
- npm @mdgate/numbers
- license MIT
- runtime Node.js · Edge · browser
Starting local converter
Use Numbers to Markdown in your app
$
npm install @mdgate/numbers
import { toMarkdown } from '@mdgate/numbers';
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 Numbers to Markdown works
- Numbers
- iWork table parsing
- sheets · tables · cells
- GitHub-Flavored Markdown
Built for JavaScript runtimes
Cloudflare Workers
Parse Numbers files directly inside Workers without Numbers or a native binary.
Browser
Convert Numbers files locally without uploading them to a server.
Edge
Run the same TypeScript converter in compatible Edge runtimes.
What @mdgate/numbers extracts
- Sheets and tables as Markdown tables
- Cell text in table order
- Table structure from the iWork archive
Why @mdgate/numbers
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
Numbers files can stay inside your application or browser.
Content detection
Recognizes Numbers files from their contents, not only the filename.
Deterministic parsing
The same Numbers file produces repeatable Markdown without model inference.
Small runtime surface
No Python. No native addons. No WASM. No third-party runtime dependencies.
Numbers for AI agents
Turn Numbers files into content your agent can actually work with.
- Numbers
- Markdown
-
- grep
- search
- chunk
- index
- cache
- cite
- reason
Need more than Numbers?
One format
@mdgate/numbers
Your own set
@mdgate/core
+ @mdgate/numbers
+ @mdgate/pdf
+ @mdgate/docx
Broad file support
@mdgate/converters
FAQ
Can I convert Numbers to Markdown without uploading it?
Yes. Numbers files can be converted locally in the browser.
Does Numbers to Markdown work in Cloudflare Workers?
Yes. @mdgate/numbers 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 Numbers converter?
Yes. Install @mdgate/numbers instead of the complete converter set.
Does this convert Excel?
No. Excel workbooks use @mdgate/xlsx.