Your PDFs Are Eating Your LLM's Tokens for Breakfast

The left path is where most of us live.

The right path is where I want to take you.

Enter MarkItDown

The fix is a free, open-source tool from Microsoft called MarkItDown.

It has blown past 110,000 stars on GitHub (sitting around 119k as I write this), so this is not some abandoned weekend hack.

It is a "boring tool that just works," which in developer language is the highest possible compliment.

What it does is beautifully simple. You give it a file, and it hands you back clean Markdown. That is it. That is the whole trick.

And by "a file" I mean almost anything you can throw at it: PDFs, Word docs, Excel sheets, PowerPoint decks, images, audio, HTML, and yes, even YouTube links, which it happily turns into a transcript.

It is a bit of a "convert anything to Markdown" Swiss Army knife.

Why does Markdown help so much? Two reasons, and both matter.

First, Markdown is featherweight. It keeps the structure that carries meaning (headings, lists, tables, links) and throws out the formatting fluff that does not. Less noise, fewer tokens, up to around 70 percent lighter in the good cases. Your mileage will vary, but the direction is always down.

Second, and this is the part people sleep on, models actually read Markdown better.

Mainstream LLMs were trained on mountains of Markdown and speak it natively.

They will even reach for it in their own answers when you did not ask them to.

So you are not just spending fewer tokens, you are handing the model its favorite format on a silver platter.

It is a genuine handshake moment.

Setup is about a two-minute job. You install the package with pip, drop a small block into your client's MCP config, and then fully quit and reopen the app.

That last step trips people up constantly, so let me say it loudly: the MCP server only loads on a clean launch.

Closing the window is not quitting. Cmd or Ctrl plus Q, then reopen. Otherwise you will sit there wondering why nothing happened.

One honest note. This auto-magic only kicks in on clients that support MCP.

If you are in a plain browser chat, you can still get all the savings, you just run the file through MarkItDown yourself first and paste the Markdown in. Slightly more manual, same payoff.

If you want to poke at it yourself, here is where to start:

• The main repo:
  

Go convert something. Your token budget has suffered enough.

If you tried this and it saved you a pile of tokens tell me in the comments. I read them.

/ | | | | | |

GenAI today is a race car without brakes. It accelerates fast -- you describe something, and large blocks of code appear instantly. But AI agents silently break things: they remove logic, relax constraints, introduce expensive cloud calls, leak credentials, and change behavior -- without telling you. You often find out in production.

git-lrc is your braking system. It hooks into git commit and runs an AI review on every diff before it lands. 60-second setup. Completely free.

In short, git-lrc helps Prevent Outages, Breaches, and Technical Debt Before They Happen

At a glance: · every commit…