markitdown

Convert PDFs, DOCX, PPTX, XLSX, and images to Markdown.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/ContractorKeith/openclaw-home --skill markitdown-contractorkeith
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: markitdown
Source: https://github.com/ContractorKeith/openclaw-home/tree/main/workspace-william/skills/markitdown
Command: npx skills add https://github.com/ContractorKeith/openclaw-home --skill markitdown-contractorkeith

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires markitdown, openai, and includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

MarkItDown streamlines the transformation of diverse file formats into clean, machine-friendly Markdown to simplify storage, search, and downstream processing by LLMs and automation pipelines.

Core Features & Use Cases

  • PDF, DOCX, PPTX, XLSX, HTML, CSV, JSON, XML, EPUB, ZIP: convert to Markdown with structured output
  • Images and scanned documents: OCR-based text extraction and optional AI-driven image descriptions
  • Audio files: transcription and metadata extraction
  • YouTube and web sources: fetch transcripts or content summaries
  • Pluginable architecture and optional Azure Document Intelligence integration for enhanced accuracy
  • Batch and streaming conversions with scripting support for automation
  • Integration with OpenRouter/OpenAI for AI-assisted descriptions (optional)

Quick Start

Use MarkItDown to convert a supported file (e.g., a PDF or DOCX) to Markdown with optional AI enhancements.

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 DOCX files to Markdown for LLM processing?

To convert PDF and DOCX files to Markdown, you can use a Python-based converter that transforms diverse document formats into clean, machine-friendly text for downstream LLM processing. It handles structured output extraction from these files.

Can I extract text from scanned images using OCR and output Markdown?

Yes, you can extract text from images and scanned documents using OCR-based text extraction. The conversion process outputs clean Markdown and optionally integrates AI-driven image descriptions via OpenRouter.

What is the best way to batch convert documents like PPTX and XLSX to Markdown?

The best way to batch convert PPTX and XLSX files is using a script-driven batch processor that supports streaming conversions. This converts multiple documents into Markdown for research and data pipelines.

Does converting YouTube sources and audio files to Markdown include transcription?

Yes, converting YouTube sources and audio files to Markdown includes transcription and metadata extraction. This fetches transcripts or content summaries for downstream processing.

Do I need Azure Document Intelligence integration for accurate PDF to Markdown conversion?

No, you do not need Azure Document Intelligence integration as it is optional. The converter natively parses PDFs to Markdown, but enabling Azure provides enhanced accuracy for complex layouts.