markitdown

Convert PDF, DOCX, PPTX, XLSX, images, audio, HTML, CSV, JSON, XML, ZIP, YouTube URLs, and EPubs to Markdown.

13|3|Updated Jun 10, 2026
One-click install
npx skills add https://github.com/tassiovale/claude-code-kit --skill markitdown-tassiovale
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: markitdown
Source: https://github.com/tassiovale/claude-code-kit/tree/main/skills/markitdown
Command: npx skills add https://github.com/tassiovale/claude-code-kit --skill markitdown-tassiovale

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 automates the conversion of various document formats into Markdown, enabling streamlined content generation and easy manipulation with AI language models.

Core Features & Use Cases

  • Format Conversion: Converts PDF, DOCX, PPTX, XLSX, images, audio, HTML, CSV, JSON, XML, ZIP, YouTube URLs, EPubs, and more to Markdown.
  • AI Image Descriptions: Generates detailed descriptions for images within documents.
  • Use Case: Convert scientific papers, reports, and presentations into Markdown format for efficient processing by AI models.

Quick Start

Convert a PDF document to Markdown using the MarkItDown skill:

markitdown document.pdf > 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 a PDF document to Markdown for AI text processing?

To convert a PDF document to Markdown, you can use the MarkItDown skill by running a simple command like `markitdown document.pdf > output.md` to extract text and metadata into a compatible format.

What file formats can be converted to Markdown format?

Markdown format conversion supports PDF, DOCX, PPTX, XLSX, images, audio, HTML, CSV, JSON, XML, ZIP, YouTube URLs, and EPubs, utilizing Python libraries for format-specific parsing and text extraction.

Can I generate AI descriptions for images during document conversion?

Yes, AI image descriptions are generated automatically during the document conversion process, creating detailed text summaries for images found within the source files to enhance Markdown output.

How do I extract tables from an Excel spreadsheet into Markdown?

You can extract tables from an Excel spreadsheet by processing the XLSX file through the document conversion skill, which handles table conversion and outputs the structured data in Markdown format.

Does converting documents to Markdown work for scientific papers and reports?

Yes, converting scientific papers, reports, and presentations into Markdown format is fully supported, enabling efficient text extraction and streamlined content generation for downstream AI models.

What is the best way to process presentations for AI language models?

The best way to process presentations is converting PPTX files into Markdown, which automates text extraction and format conversion to ensure seamless manipulation by AI language models.