markitdown

Convert PDF, DOCX, PPTX, XLSX, and other files to Markdown.

Updated Dec 17, 2025
One-click install
npx skills add https://github.com/robotlearning123/claude-scientific-skills --skill markitdown-robotlearning123
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: markitdown
Source: https://github.com/robotlearning123/claude-scientific-skills/tree/main/scientific-skills/markitdown
Command: npx skills add https://github.com/robotlearning123/claude-scientific-skills --skill markitdown-robotlearning123

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill converts various file formats to Markdown, including PDF, DOCX, PPTX, XLSX, images, audio, HTML, CSV, JSON, XML, ZIP, YouTube URLs, EPubs, and more. It also offers AI-enhanced image descriptions and OCR for scanned documents.

Core Features & Use Cases

  • File Conversion: Converts multiple file formats to Markdown.
  • AI Image Descriptions: Generates detailed descriptions of images in documents using AI models.
  • OCR: Extracts text from scanned documents and images.
  • Use Case: Convert a research paper to Markdown for easier analysis and note-taking.

Quick Start

Use the markitdown skill to convert a PDF document to Markdown format.

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

You can convert a PDF to Markdown using file conversion tools that extract text and format it into Markdown syntax. This process streamlines document analysis workflows by transforming PDFs, DOCX, and other file types into easily editable Markdown text.

Can I extract text from scanned documents and images using OCR?

Yes, you can extract text from scanned documents and images using Optical Character Recognition (OCR). This feature allows the file conversion process to capture text from image-based PDFs and image files, turning previously inaccessible scanned content into editable Markdown text.

Does file conversion to Markdown support AI-enhanced image descriptions?

Yes, converting files to Markdown supports AI-enhanced image descriptions. This feature utilizes AI models to generate detailed textual summaries of images embedded within documents, seamlessly integrating this generated context directly into the final Markdown output.

What is the best way to convert XLSX and CSV files to Markdown format?

The best way to convert XLSX and CSV files to Markdown is using a dedicated document processing tool that supports multiple file formats. It automatically translates spreadsheet content and tabular data into properly structured Markdown tables for data analysis purposes.

Do I need Python libraries to process file types like EPubs and HTML?

Yes, you need various Python libraries to process file types like EPubs, HTML, XML, and ZIP during Markdown conversion. These dependencies are required to accurately parse different file structures and extract the information needed for the final output.