CodeariaAcademy
GitHub repositorycommit this monthContentDevelopment

markitdown

191k

Turns PDF, Word, Excel, PowerPoint and images into clean markdown a model can read without losing the structure.

We have not run it ourselves: described from the docs and the repository.

In numbers

licence

What it is

The problem is familiar to anyone who has fed documents to a model: inside, a PDF holds not text but character coordinates on a page. Hand one over directly and the table falls apart, headings blend into captions, and column order becomes a matter of luck. Microsoft's markitdown converts the document into markdown and keeps the structure: headings stay headings, tables stay tables, lists stay lists.

The model then reads the document the way a person does rather than as a stream of words. "Let the model read this document" comes up all the time, and here it is handled by one utility that runs locally. The documents go nowhere, which matters when they are contracts or an export from your own database.

How it works

PDF, Office
PDF, Word, Excel, PowerPoint, HTML and EPub become markdown with headings, tables and lists intact.
images
Text is pulled out of images with text recognition.
audio
Audio is transcribed into text.
ZIP, YouTube
Handles ZIP archives and YouTube links.
MCPfor agents
There is an MCP server if you would rather hand the conversion to an agent than run it yourself; the utility itself installs through pip.

Comments