Installation

How to install MarkItDown with pip, from source, or with specific optional dependencies for PDF, DOCX, PPTX and more file formats.

To install MarkItDown, use pip:

pip install 'markitdown[all]'

Alternatively, you can install it from the source:

git clone git@github.com:microsoft/markitdown.git
cd markitdown
pip install -e 'packages/markitdown[all]'

Tip

Not every optional dependency is required for every use case. See Optional Dependencies to install only what you need.

Once installed, head to Usage → Command Line or Usage → Python API to start converting files.

Prerequisites

Prerequisites for MarkItDown: Python 3.10+ and how to set up a virtual environment with venv, uv, or Anaconda before installing.

Command Line

Convert files to Markdown from the command line with the markitdown CLI, including piping, custom output files, and plugin support.