markitdown

Convert PDFs, DOCX, PPTX, XLSX, HTML, JSON, and XML files into Markdown.

Updated May 24, 2026
One-click install
npx skills add https://github.com/Estrella-231/Mathematical_modeling_tongmeng --skill markitdown-estrella-231
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: markitdown
Source: https://github.com/Estrella-231/Mathematical_modeling_tongmeng/tree/main/.agents/skills/markitdown
Command: npx skills add https://github.com/Estrella-231/Mathematical_modeling_tongmeng --skill markitdown-estrella-231

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires requests, python-dotenv, tesseract, and includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

MarkItDown eliminates the manual effort of copying, cleaning, and reformatting content from office documents and other file types by automatically converting them into LLM-friendly Markdown.

Core Features & Use Cases

  • Convert documents to structured Markdown: Transform PDFs, DOCX, PPTX, XLSX/CSV, HTML, JSON/XML, and more into readable Markdown text.
  • Improve extraction for visual and complex inputs: Supports OCR for images/scanned documents and can generate AI-enhanced image descriptions (optionally).
  • Use case: Convert a set of research papers and slides into Markdown so you can quickly search, summarize, and build downstream analysis prompts without format friction.
  • Optional plugins and automation: Enable plugin-based converters and use batch conversion scripts to process many files efficiently.

Quick Start

Convert your file into Markdown by running markitdown your_document.pdf -o output.md.

Frequently Asked Questions about markitdown

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I convert PDF and PPTX files to Markdown for LLM processing?

To convert PDF and PPTX files to Markdown for LLM processing, run the markitdown command on your document and specify an output file. This automatically extracts text and tables into clean, readable Markdown.

Does converting scanned PDFs to Markdown require OCR?

Converting scanned PDFs to Markdown requires OCR to recover text from images. The conversion process applies optical character recognition through configured tools to extract readable text from visual inputs.

Can I batch convert multiple office documents into Markdown at once?

You can batch convert multiple office documents into Markdown using the provided batch conversion scripts. These scripts allow you to process many files efficiently through plugin-based converters.

What is the best way to extract tables from XLSX and CSV files into Markdown?

The best way to extract tables from XLSX and CSV files into Markdown is using an automated document ingestion tool. It detects the input format and extracts spreadsheet content directly as structured Markdown tables.

Do I need Tesseract installed to perform OCR on images?

You need Tesseract installed to perform OCR on images because it handles the optical character recognition dependency. This allows the converter to recover text from scanned documents and image files.

What limitations exist when converting complex HTML and XML to Markdown?

Limitations when converting complex HTML and XML to Markdown include potential formatting loss from intricate web structures. The converter focuses on extracting readable text and tables, so highly complex layouts may not translate perfectly.