markitdown

Convert PDF, DOCX, PPTX, XLSX, images, audio, HTML, CSV, JSON, XML, ZIP, EPubs, and YouTube URLs into Markdown.

8|Updated Jan 13, 2026
One-click install
npx skills add https://github.com/hxk622/TokenDance --skill markitdown-hxk622
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: markitdown
Source: https://github.com/hxk622/TokenDance/tree/main/backend/app/skills/builtin/scientific/writing/markitdown
Command: npx skills add https://github.com/hxk622/TokenDance --skill markitdown-hxk622

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill streamlines the process of converting a wide variety of 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 (with OCR), audio (with transcription), HTML, CSV, JSON, XML, ZIP, YouTube URLs, and EPubs.
  • AI-Enhanced Descriptions: Can generate detailed descriptions for images within documents using LLMs.
  • Use Case: Convert a complex research paper in PDF format, along with its figures, into a single, well-structured Markdown document for easier analysis and summarization by an AI.

Quick Start

Use the markitdown skill to convert the file named 'report.docx' 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 or DOCX files to Markdown for LLM processing?

You can convert PDF, DOCX, and over 15 other file formats to Markdown using the markitdown skill. It streamlines document ingestion by transforming complex files into a single, well-structured Markdown document for easier analysis by LLMs.

Can I extract text from images using OCR when converting files to Markdown?

Yes, you can extract text from images using OCR when converting files to Markdown. The conversion process supports OCR for image-based text extraction and can also generate AI-enhanced image descriptions via LLM integration.

Does the file to Markdown conversion process support audio transcription and YouTube URLs?

Yes, the file to Markdown conversion process supports audio transcription and YouTube URLs. It converts a wide array of formats including audio files with transcription and YouTube video links directly into Markdown format.

What is the best way to convert XLSX, CSV, or JSON data into Markdown format?

The best way to convert XLSX, CSV, or JSON data into Markdown format is to use a universal conversion tool like markitdown. It supports these specific data formats along with XML and ZIP files, preparing the structured data for LLM processing.

How do I prepare complex research papers with figures for AI analysis?

To prepare complex research papers with figures for AI analysis, convert the PDF and its images into a single Markdown document. This process uses OCR and AI-enhanced image descriptions to ensure all text and visual data are digestible by LLMs.

What file formats are supported by universal Markdown conversion tools?

Universal Markdown conversion tools like markitdown support over 15 file formats including PDF, DOCX, PPTX, XLSX, images, audio, HTML, CSV, JSON, XML, ZIP, EPubs, and YouTube URLs. This wide support facilitates comprehensive document ingestion.