markitdown

Convert diverse document formats into Markdown text.

3|1|Updated Feb 26, 2026
One-click install
npx skills add https://github.com/imvladikon/dot-claude --skill markitdown-imvladikon
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: markitdown
Source: https://github.com/imvladikon/dot-claude/tree/main/skills/markitdown
Command: npx skills add https://github.com/imvladikon/dot-claude --skill markitdown-imvladikon

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

Converts a wide range of document formats into Markdown text, enabling token-efficient processing and easy reuse in LLM-driven workflows.

Core Features & Use Cases

  • PDF/Docx/PPTX/XLSX/HTML/CSV/JSON/XML to Markdown with preserved structure and formatting
  • OCR for images and scanned documents, audio transcription, and AI-assisted image descriptions
  • Batch processing, plugin support, and frontmatter-driven metadata for organized literature and data workflows
  • Use cases include scientific paper conversion, data extraction, and presentation content preparation

Quick Start

Convert a sample.pdf to Markdown using MarkItDown to verify the 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 Word documents to Markdown automatically?

To convert PDF and Word documents to Markdown automatically, you can use a document conversion tool that preserves structure and formatting. This skill supports PDFs, DOCX, PPTX, and XLSX, transforming them into clean Markdown text for token-efficient processing.

What is the best way to extract text from scanned PDFs and images for data analysis?

The best way to extract text from scanned PDFs and images is using OCR capabilities integrated into a document conversion workflow. This skill applies OCR to images and scanned documents, converting them into Markdown text suitable for data analysis and research.

Can I batch process multiple documents like spreadsheets and presentations into Markdown?

Yes, you can batch process multiple documents into Markdown. This skill features batch processing support with a pluggable architecture, allowing you to convert spreadsheets, presentations, and other document formats simultaneously for organized data workflows.

Does this document conversion approach support audio transcription and YouTube transcripts?

Yes, this document conversion approach supports audio transcription and YouTube transcripts. It converts diverse formats including audio files and YouTube transcripts into Markdown text, enabling token-efficient processing for research and documentation workflows.

Do I need OpenAI to generate AI descriptions for images during document conversion?

Yes, you need OpenAI to generate AI descriptions for images during document conversion. This skill uses OpenAI dependencies to provide AI-assisted image descriptions, enhancing the Markdown output when processing documents containing visual content.

What are the limitations of converting complex formats like EPUBs and ZIP files to Markdown?

When converting complex formats like EPUBs and ZIP files to Markdown, limitations may arise from deeply nested structures or proprietary encoding. While this skill supports these formats, heavily formatted elements might not translate perfectly into token-efficient Markdown text.