markitdown

Convert PDF, DOCX, PPTX, XLSX, images, audio, HTML, and more into Markdown.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/Zehong-Wang/Kosmos --skill markitdown-zehong-wang
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: markitdown
Source: https://github.com/Zehong-Wang/Kosmos/tree/main/kosmos-reference/kosmos-claude-scientific-writer/.claude/skills/markitdown
Command: npx skills add https://github.com/Zehong-Wang/Kosmos --skill markitdown-zehong-wang

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill automates the conversion of various file formats into Markdown, making documents easily digestible for LLMs and simplifying content management.

Core Features & Use Cases

  • Broad Format Support: Converts PDFs, DOCX, PPTX, XLSX, images, audio, HTML, and more.
  • AI-Enhanced Descriptions: Generates detailed descriptions for images and presentations using AI models.
  • Use Case: Convert a collection of research papers, presentations, and data spreadsheets into Markdown for a unified knowledge base that can be easily queried by an AI.

Quick Start

Use the markitdown skill to convert the attached file 'report.pdf' into a markdown file.

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

To convert PDF and DOCX files to Markdown for LLM processing, you can use automated conversion tools that extract text and structure into a digestible format. This Skill specifically transforms PDFs, DOCX, and other formats into Markdown, making documents easily digestible for LLMs.

Can I convert YouTube URLs and audio files into Markdown text?

Yes, you can convert YouTube URLs and audio files into Markdown text. The conversion process supports extracting content from YouTube URLs and audio files, turning them into structured Markdown format for unified content management and AI querying.

Does converting PDF to Markdown support AI-enhanced image descriptions?

Converting PDF to Markdown supports AI-enhanced image descriptions via OpenRouter and Azure Document Intelligence. This generates detailed descriptions for images and presentations within your documents during the conversion process.

What is the best way to convert XLSX and CSV data spreadsheets into Markdown?

The best way to convert XLSX and CSV data spreadsheets into Markdown is using an automated file conversion tool. This Skill supports converting XLSX, CSV, and JSON formats into Markdown, allowing you to build a unified knowledge base from structured data.

What file formats are supported when converting documents to Markdown?

Supported file formats for converting documents to Markdown include PDF, DOCX, PPTX, XLSX, images, audio, HTML, CSV, JSON, XML, ZIP, and EPUB. This broad format support automates conversion for a unified knowledge base.