microsoft/markitdown

Python tool for converting files and office documents to Markdown.

Open original source ↗

From the publisher

README & documentation

Source preview

Read the project’s overview, installation instructions and usage examples. The original README is the source of truth.

[](https://pypi.org/project/markitdown/) MarkItDown is a lightweight Python utility for converting various files to Markdown for use with LLMs and related text analysis pipelines. To this end, it is most comparable to textract, but with a focus on preserving important document structure and content as Markdown (including: headings, lists, tables, links, etc.) While the output is often reasonably presentable and human-friendly, it is meant to be consumed by text analysis tools -- and may not be the best option for high-fidelity document conversions for human consumption. MarkItDown currently supports the conversion from: Markdown is extremely close to plain text, with minimal markup or formatting, but still provides a way to represent important document structure. Mainstream LLMs, such as OpenAI's GPT-4o, natively "speak" Markdown, and often incorporate Markdown into their responses unprompted. This suggests that they have been trained on vast amounts of Markdown-formatted text, and understand it well. As a side benefit,…

microsoft/markitdown on GitHub A short preview, not the full document.

Read the full README ↗ · Preview checked 2026-10-29T00:21:41.176Z

Inside the original README — Document outline
  1. MarkItDown
  2. Why Markdown?
  3. Prerequisites
  4. Installation
  5. Usage
  6. Command-Line
  7. Optional Dependencies
  8. Plugins
  9. markitdown-ocr Plugin
  10. Azure Content Understanding
  11. When to use Content Understanding
  12. Azure Document Intelligence

Headings are captured from the source. Links open the publisher’s document, not a locally hosted copy.

Links from the README

References supplied by the publisher, not independently verified endorsements. Check the destination before downloading files or entering credentials.

Documentation belongs to its respective authors. Reported project/model license: MIT. A listing is not a grant of reuse or training rights. Confirm the document’s own terms at the source.

What this repository does

Python tool for converting files and office documents to Markdown.

Repository facts

Owner
microsoft
Primary language
Python
Stars
193,326
Forks
14,486
Open issues + pull requests
782
License
MIT
Archived
No
Default branch
main
Created
2024-11-13T19:56:40.000Z
Last push
2026-10-28T15:33:14.000Z

Topics and intended use

Owner-supplied topics: autogen, autogen-extension, langchain, markdown, microsoft-office, openai, pdf

Review the README for scope, installation, examples and limitations. We do not run repository code or certify it.

Evaluate before installing

Review licensing and dependencies, inspect recent commits and unresolved issues, and test in an isolated environment before production use. Stars and forks alone cannot answer these questions.

README and project files

Issues and maintenance discussion

Releases and changelog

Source and freshness

Source: GitHub. Metadata observed 2026-11-01T12:17:40.351Z. Daily imports are snapshots, not real-time monitoring.

Popularity and source listings do not establish security, suitability, licensing rights or benchmark performance.

Open original source

Related repositories

public-apis/public-apis

EbookFoundation/free-programming-books

donnemartin/system-design-primer

vinta/awesome-python

practical-tutorials/project-based-learning

NousResearch/hermes-agent