markitdown

Convert PDF, DOCX, PPTX, XLSX, images, audio, HTML, and YouTube files into Markdown.

6|Updated Dec 30, 2025
One-click install
npx skills add https://github.com/pur3v4d3r/pur3-pkb-codebase --skill markitdown-pur3v4d3r
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: markitdown
Source: https://github.com/pur3v4d3r/pur3-pkb-codebase/tree/main/.claude/skills/__scientific-skills/markitdown
Command: npx skills add https://github.com/pur3v4d3r/pur3-pkb-codebase --skill markitdown-pur3v4d3r

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 reduces the time and effort of converting diverse file formats (PDF, DOCX, PPTX, XLSX, images, audio, HTML, YouTube, and more) into clean, consistent Markdown that is easy to ingest into AI workflows and data pipelines.

Core Features & Use Cases

  • Supports PDFs, Word, PowerPoint, Excel, images with OCR, audio transcription, HTML, CSV/JSON/XML, ZIP archives, and YouTube transcripts.
  • Provides AI-enhanced image descriptions and Azure Document Intelligence integration for complex layouts.
  • Batch processing and metadata extraction to organize content for literature reviews, data analysis, or documentation workflows.

Quick Start

Convert a sample document to Markdown to verify the installation and basic workflow.

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 ingestion?

Yes, image-to-Markdown conversion supports AI-enhanced descriptions via OpenAI or OpenRouter. The skill uses OCR technology to extract text from images, generating clean Markdown that is easy to ingest into AI workflows and research pipelines.

Can I batch convert multiple documents to Markdown at once?

Batch processing is supported to convert multiple documents into Markdown simultaneously. This feature extracts metadata and organizes content efficiently, streamlining large-scale documentation workflows and literature reviews without manual file-by-file conversion.

Does this tool require Azure Document Intelligence for complex PDF layouts?

Azure Document Intelligence is an optional integration for handling advanced PDF layouts, not a strict requirement. The core file conversion to Markdown works independently, while Azure provides enhanced capabilities for parsing complex documents and research papers.

What is the best way to extract YouTube transcripts and audio into Markdown?

The best way to extract YouTube transcripts and audio into Markdown is through automated transcription features. The skill processes audio files and YouTube links, converting spoken content into clean, structured Markdown text ready for AI analysis and documentation.

What file formats are supported when converting documents to Markdown?

Supported file formats for converting documents to Markdown include PDF, DOCX, PPTX, XLSX, HTML, CSV, JSON, XML, and ZIP archives. The skill also handles images with OCR and audio files, ensuring diverse content types are transformed into consistent Markdown.