markitdown

Convert documents, images, and audio files into Markdown.

2|Updated Feb 2, 2026
One-click install
npx skills add https://github.com/Weiwei-Mao/hydrology-skills --skill markitdown-weiwei-mao
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: markitdown
Source: https://github.com/Weiwei-Mao/hydrology-skills/tree/main/hydrology-skills/markitdown
Command: npx skills add https://github.com/Weiwei-Mao/hydrology-skills --skill markitdown-weiwei-mao

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill streamlines the process of converting various file formats into Markdown, making content easily digestible and processable by LLMs.

Core Features & Use Cases

  • Universal Conversion: Supports over 15 file formats including PDF, DOCX, PPTX, XLSX, images, audio, and more.
  • LLM-Friendly Output: Generates clean, token-efficient Markdown suitable for AI models.
  • AI-Enhanced Descriptions: Can generate detailed descriptions for images within documents using AI models.
  • Use Case: Convert a complex research paper in PDF format into Markdown for easier analysis by an AI assistant, or transform a PowerPoint presentation into a structured Markdown document.

Quick Start

Use the markitdown skill to convert the file 'report.pdf' into markdown format and save it as 'report.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?

You can convert a PDF to Markdown for LLM processing by using this tool to transform documents into a clean, token-efficient text representation. It generates output specifically designed for AI model analysis.

What is the best way to convert PPTX and DOCX files into Markdown?

Converting PPTX and DOCX files into Markdown is done using this universal conversion tool. It supports over 15 file formats, transforming presentations and documents into structured, LLM-friendly text.

Can I generate AI descriptions for images found in a converted document?

You can generate AI descriptions for images found in a converted document using this Skill. It features AI-enhanced image descriptions to provide detailed context for visual elements during the file to Markdown conversion.

How do I handle scanned documents when converting to Markdown?

Handling scanned documents when converting to Markdown is supported by this Skill through built-in OCR capabilities. It processes scanned document images and converts the extracted text into a standardized Markdown format.

Does this file conversion tool support extracting text from audio files?

This file conversion tool supports extracting text from audio files by converting a wide range of formats into Markdown. It provides a standardized text representation for LLMs.