Clean the text.
Keep the meaning.
Convert supported files to Markdown, decide when conversion helps, and optionally add the local MCP server.
Use Microsoft MarkItDown with Claude
The video claims every PDF page costs 1,000–3,000 tokens and conversion saves up to 70%. Neither figure is a reliable general rule. Token use depends on file content, model and upload path, while conversion can lose visual information. MarkItDown is a real Microsoft open-source project; use it when a text-first representation suits the task.
One useful step at a time.
- 01Inspect the file
- 02Convert a copy
- 03Check fidelity
- 04Send the right format
Decide whether to convert
If you need headings and body text from a long report, Markdown may be easier to inspect, search and reuse. If you need charts, figures, scanned pages, exact tables, signatures or visual layout, keep the original PDF or include relevant page images. Compare the output before assuming Markdown is smaller or better.
MarkItDown supports PDF, Word, PowerPoint, Excel, HTML, images, audio and other formats, with format-specific dependencies. A YouTube URL is also supported, but availability of transcripts and media metadata can affect output.
Install and convert a copy
Use a supported Python version in a virtual environment. Microsoft’s repository documents installing the package with selected extras or markitdown[all]. For a text-first PDF and Office workflow, start with only the formats you need.
python3 -m venv .venv
source .venv/bin/activate
pip install 'markitdown[pdf,docx,pptx,xlsx]'
markitdown input.pdf -o output.mdOpen output.md and check headings, tables, footnotes and missing figures. Keep the original file as the authority. If the converted output is poor, use the original upload or a better extraction method.
Optional MCP server
Microsoft also maintains markitdown-mcp, a local server exposing a conversion tool. Follow its current README for installation and Claude connection settings; the exact configuration depends on your Claude client. The server can read files that its process can access, so choose trusted files and keep the service local.
The video’s claim that every file upload “automatically” converts is not a default MarkItDown feature. To automate it, you would need a separate workflow or a client that invokes the conversion tool before sending content.
Measure instead of guessing
Run a representative task twice: once with the original document and once with checked Markdown. Compare answer quality, omitted details and any usage information your client shows. A small, clean Markdown extract can be more useful than a whole document; a complex illustrated PDF may need the original pages.
Answer my question using this converted Markdown. Before answering, list any tables, figures, footnotes or sections that appear missing from the conversion and tell me whether the original file is needed.
Sources & notes
Product details were checked on 5 October 2026. Menus, plans, and integrations can change. The video is the source of the lead-magnet promise; the links below support the practical instructions and corrections in this guide.
- Microsoft MarkItDown: Supported formats, CLI, and conversion limits.
- Microsoft MarkItDown MCP: Local server setup and tool scope.
- Upload files to Claude: Supported documents and images.
The numeric token-saving claims in the video are unverified and are intentionally omitted from the procedure.