markitdown

Convert PDFs, DOCX, PPTX, XLSX, images, audio, HTML, CSV, JSON, XML, ZIP, EPUB, and YouTube URLs into Markdown.

Updated Apr 17, 2026
One-click install
npx skills add https://github.com/ccstudentcc/agent-prompts --skill markitdown-ccstudentcc
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: markitdown
Source: https://github.com/ccstudentcc/agent-prompts/tree/main/.codex/skills/markitdown
Command: npx skills add https://github.com/ccstudentcc/agent-prompts --skill markitdown-ccstudentcc

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 converts a wide range of document formats into clean, Markdown, enabling token-efficient, LLM-ready text for analysis, review, and automation.

Core Features & Use Cases

  • Convert PDFs, Word, PowerPoint, Excel, HTML, CSV, JSON, XML, ZIP archives, images with OCR, and audio transcripts into Markdown.
  • AI-enhanced image descriptions and optional Azure Document Intelligence support for richer outputs.
  • Batch processing, CLI and Python API, and a flexible plugin system to extend conversion workflows.
  • Use case: In research or documentation pipelines, rapidly generate consistent Markdown from heterogeneous sources for knowledge extraction and collaboration.

Quick Start

Install MarkItDown and run the convert method on a sample file to obtain Markdown output.

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

You can convert PDFs, Word documents, and other formats to Markdown using a document conversion tool that processes files individually or in batches, producing clean, token-efficient text for LLM analysis and review workflows.

Can I extract text from images and audio using Markdown conversion?

Yes, Markdown conversion tools can extract text from images using OCR technology and transcribe audio files. Some tools also support AI-powered image descriptions, generating rich Markdown outputs that include both transcribed text and contextual visual descriptions.

Does Azure Document Intelligence work with Markdown document conversion?

Azure Document Intelligence is supported as an optional integration for Markdown document conversion. When enabled, it enhances the extraction process, providing richer outputs for complex documents by leveraging Azure's advanced document analysis capabilities alongside standard conversion methods.

What is the best way to batch convert heterogeneous files like PPTX, XLSX, and HTML to Markdown?

The best way to batch convert heterogeneous files to Markdown is using a tool with a CLI or Python API that supports diverse formats like PPTX, XLSX, and HTML. This ensures consistent Markdown output, accelerating knowledge extraction and collaboration in documentation pipelines.

Do I need OpenAI to use AI descriptions for image conversion to Markdown?

You need an AI service like OpenAI to generate AI-powered image descriptions during conversion to Markdown. This integration allows the tool to analyze images and produce contextual text descriptions, creating more comprehensive and useful Markdown output for your documents.

Can I convert YouTube URLs and ZIP archives to Markdown format?

Yes, you can convert YouTube URLs and ZIP archives to Markdown format. The tool processes these inputs alongside standard formats like PDF and DOCX, extracting relevant text and metadata to produce consistent Markdown files for documentation or knowledge management workflows.