markitdown-cli

name	markitdown-cli
description	Use this skill when the user wants to convert documents, URLs, or typed stdin content to Markdown with the markitdown CLI. It covers local files, URLs, format hints for stdin, batch conversion, third-party plugins, and Azure Document Intelligence workflows.

MarkItDown CLI Usage Guide

MarkItDown is a command-line tool for converting many file and URL inputs into Markdown. It works well for PDFs, Office documents, HTML, feeds, archives, and several optional plugin-backed workflows.

Basic Usage

# Convert a file to stdout
markitdown document.pdf

# Save Markdown to a file
markitdown document.pdf > document.md
markitdown document.pdf -o document.md

# Convert a URL
markitdown https://example.com/report.pdf
markitdown https://example.com/article -o article.md

# Read from stdin with an explicit type hint
cat page.html | markitdown -x html
cat payload | markitdown -m text/html

Common CLI Flags

Flag	Description
-o, --output FILE	Write output to FILE instead of stdout
-x, --extension EXT	Hint the file extension, especially when using stdin
-m, --mime-type MIME	Hint the MIME type
-c, --charset CHARSET	Hint the character encoding
-d, --use-docintel	Use Azure Document Intelligence
-e, --endpoint URL