Token benchmarks & methodology

Every percentage on this site comes from the benchmark below — one corpus, one tokenizer, defined baselines, per-file results. Version 1, measured 8 August 2026. When we re-run it, this page and every number that cites it change together.

How we count

Counts use OpenAI’s o200k_base tokenizer (via tiktoken, offline). One honest caveat up front: o200k is OpenAI’s tokenizer, not Anthropic’s — Claude tokenizes differently, and absolute counts vary by model. We use one tokenizer as a consistent estimate because the ratios between formats are far more stable than the absolute counts, and ratios are what we publish. The token badge in the app is an estimate for the same reason.

A second caveat: with API prompt caching, repeated reads of the same attachment get cheaper, so the dollar saving shrinks on later turns. The context-window saving — how much of the model’s working memory your document occupies — does not shrink.

Web pages: 72–95% fewer tokens

Baseline: the page’s raw HTML source, as fetched — what you’d paste if you saved the page. Five real public pages, chosen for chrome-to-content diversity:

PageRaw HTML tokensMarkdown tokensSaving
GitHub — microsoft/markitdown143,8186,67095.4%
Wikipedia — Markdown97,30517,77181.7%
Wikipedia — Switzerland542,470134,10675.3%
MDN — HTTP Overview61,21216,91172.4%
Python docs — Tutorial21,9246,18071.8%

Lean documentation pages sit near 72%; app-shell-heavy pages like GitHub approach 95%. If you paste browser-selected text instead of page source, your baseline — and your saving — lands somewhere in between.

PDFs: 68–90% fewer tokens vs native upload

Baseline: attaching the PDF natively, which providers bill as extracted text plus a per-page image — Anthropic documents roughly 1,500–3,000 tokens per page. The Markdown carries the same words as the PDF’s text layer, so the saving is that per-page image cost; we report both bounds rather than picking the flattering one.

DocumentPagesMarkdown tokensNative upload (est.)Saving
arXiv 2506.16035 (research paper)2114,81646,316–77,81668.0–81.0%
Milldown technical design doc209,40639,406–69,40676.1–86.4%
Keydock technical design doc186,13533,135–60,13581.5–89.8%
Pricing research report94,40517,905–31,40575.4–86.0%

Text-sparse pages save more, because the fixed per-page image cost dominates. Scanned PDFs go through on-device OCR first and then follow the same arithmetic.

Spreadsheets: CSV beats Markdown tables by 12–29%

Baseline: identical cell data as a Markdown pipe table vs as CSV. This is the format where Markdown loses — and where we correct ourselves: we previously published 32–39% for this saving; the v1 benchmark measures 12–29%, and the smaller number is the one we now claim. Three generated sheets (deterministic, shapes disclosed in the repo manifest):

SheetMarkdown table tokensCSV tokensCSV saving
Transaction log (400×8)15,29811,90122.2%
KPI grid (60×14, numeric)5,1083,60729.4%
Personnel directory (150×6)3,9453,46612.1%

Numeric-dense grids save the most; text-heavy tables the least. Milldown’s CSV output mode exists exactly for this: Markdown tables when a human reads them, CSV when a model does.

Word & PowerPoint: no saving claimed

You will see other tools claim ~97% savings for Office files by comparing Markdown against the raw OOXML inside the file. Our corpus reproduces that number — 94.1% and 96.8% on two real documents — and we still don’t claim it, because no chat workflow pays that baseline: every tool extracts the text before the model sees it. Against what you’d actually otherwise send, a .docx costs about the same in Markdown. What Milldown adds for Office files is structure (real headings and tables), cleanup, and measurement — not a token discount.

Reproduce it. The corpus manifest, generator, benchmark script, and raw results.json live in the Milldown repository under packaging/benchmark/. Sources are listed with hashes; the spreadsheets are generated from a fixed seed. If your documents differ from ours — they will — the app shows the real number for every file you convert, before you send anything.

Measure your own documents

The token badge shows the before/after for each file you convert — computed on your Mac, nothing uploaded.

Join the early access

macOS 14+ · Apple Silicon · $39 one-time after trial (excl. VAT) · no subscription