markitdown

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

Updated May 17, 2026
One-click install
npx skills add https://github.com/galeep/plugin-place --skill markitdown-galeep
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: markitdown
Source: https://github.com/galeep/plugin-place/tree/main/plugins/sci-scientific-communication/skills/markitdown
Command: npx skills add https://github.com/galeep/plugin-place --skill markitdown-galeep

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill simplifies the process of converting various file formats to Markdown, making them more efficient for modern language models to process.

Core Features & Use Cases

  • File Conversion: Converts PDF, DOCX, PPTX, XLSX, images, audio, HTML, CSV, JSON, XML, ZIP, YouTube URLs, EPubs, and more to Markdown.
  • AI-Enhanced Image Descriptions: Generates detailed descriptions for images in PDFs and presentations.
  • Use Case: Convert complex scientific papers or reports into Markdown for better processing by language models and AI tools.

Quick Start

Install the markitdown skill with:

pip install 'markitdown[all]'

Then, convert a PDF to Markdown using:

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 to Markdown for LLM processing?

To convert a PDF to Markdown, you can use the markitdown package to extract text and structure, outputting a clean Markdown file. This conversion improves token efficiency when feeding scientific papers or technical reports into language models.

What file formats can be converted to Markdown besides PDF?

Besides PDF, you can convert DOCX, PPTX, XLSX, HTML, CSV, JSON, XML, ZIP, EPubs, audio files, and YouTube URLs to Markdown. Images embedded in documents are also processed to generate AI-enhanced descriptions.

Does converting documents to Markdown actually improve AI processing efficiency?

Yes, converting documents to Markdown improves token efficiency for language models. By stripping complex binary formatting and standardizing structural elements, AI tools can process scientific documentation and technical reports more effectively.

How are images in PDFs and presentations handled during file conversion?

During file conversion, images embedded in PDFs and presentations are processed using AI-enhanced image description capabilities. This generates detailed textual descriptions, ensuring visual data is accessible in the final Markdown output.

Do I need to install specific dependencies to convert DOCX or XLSX files?

Yes, you need to install the markitdown package along with associated libraries for specific format support. Using the 'markitdown[all]' installation command ensures you have the necessary dependencies to convert formats like DOCX, XLSX, and audio.

What is the best way to extract text from scientific papers for content creation workflows?

The best way to extract text from scientific papers is converting them to Markdown format. This simplifies content creation workflows by transforming complex reports into structured text that language models can process with high token efficiency.