The problem
How it works
MarkItDown is a Python utility with a CLI and an API that turns PDF, PowerPoint, Word, Excel, HTML, CSV, JSON, EPUB and other inputs into Markdown, keeping headings, lists, tables and links. You install it with optional extras per format, then call `markitdown file -o out.md` or the `convert()` method. Optional settings add LLM image descriptions or Azure Document Intelligence for layout extraction.
Results and limitations
The README positions the output as suited to text analysis and LLM pipelines, and says it keeps document structure intact.
Before you try it
The maintainers note it is not aimed at high-fidelity conversions for human readers, that Azure features can be billable, and that it runs with the current process's privileges, so untrusted files need care. Results depend on your setup and were not independently reproduced by Top 200 Repos.
Tools and repositories
- Tools
- Python 3.10+ · markitdown CLI
- Prerequisites
- No API key for local conversion; Azure Document Intelligence or an LLM client are optional and need their own credentials.
Try it yourself: Batch-convert a folder to Markdown
Fill the fields to adapt the prompt. Empty fields stay as visible [placeholders].
Convert every file in [Folder with source files] with the extensions [File types] to Markdown using MarkItDown. Before converting, list the files you found with their sizes and tell me which optional extras need installing; ask before installing anything. Write each result to [Markdown output folder], keeping the original file name with a .md extension, and never overwrite an existing file without asking. Do not enable Azure or LLM-based features unless I confirm, since they send content to a cloud service. When done, report files converted, files that failed with the error, and any tables or images that looked lost so I can spot-check them.Only convert files you trust, and keep cloud conversion off for confidential documents unless approved.
Related videos
About microsoft/markitdown
Microsoft MarkItDown: Convert Files and Office Documents to Markdown (Local Install Step by Step) (opens in a new tab)
The description links the GitHub repository.
Watch on YouTube (opens in a new tab)About microsoft/markitdown
Microsoft MarkItDown - Convert Files and Office Documents to Markdown - Install Locally (opens in a new tab)
The description links the GitHub repository.
Watch on YouTube (opens in a new tab)Independent creators. Listing a video implies no endorsement, sponsorship or partnership.
Sources
- microsoft/markitdown README (opens in a new tab)
Project documentation · github.com · Undated · Source checked 9 Nov 2026, 22:21 UTC
What this source supports
- Converts PDF, Office, HTML, CSV, JSON, EPUB and more to Markdown
- Preserves headings, lists, tables and links
- CLI and Python API usage; Python 3.10 to 3.14
- Not intended for high-fidelity human-facing conversion
- Azure Document Intelligence and Content Understanding are optional and may be billable

