markitdown

Convert diverse document formats to Markdown for AI workflows.

22|4|Updated May 25, 2026
One-click install
npx skills add https://github.com/crazymsn/academic-skills --skill markitdown-crazymsn
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: markitdown
Source: https://github.com/crazymsn/academic-skills/tree/main/academic-skills/markitdown
Command: npx skills add https://github.com/crazymsn/academic-skills --skill markitdown-crazymsn

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill converts a wide range of document formats (PDF, DOCX, PPTX, XLSX, HTML, images, audio, and more) into clean, structured Markdown to simplify ingestion by AI models and documentation workflows.

Core Features & Use Cases

  • Format coverage: PDF, DOCX, PPTX, XLSX, HTML, images with OCR, audio transcription, YouTube transcripts, and more.
  • AI-assisted enhancements: optional image descriptions and metadata extraction to enrich Markdown outputs.
  • Batch & workflow automation: supports batch conversions, literature pipelines, and integration with research docs and notes.

Quick Start

Convert a sample file (e.g., paper.pdf) to Markdown to preview the output.

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 AI workflows?

To convert PDF and DOCX files to Markdown for AI workflows, you can use an automated conversion engine that transforms diverse document formats into clean, structured Markdown. This simplifies ingestion by AI models and documentation pipelines.

What is the best way to batch convert presentations and spreadsheets to Markdown?

The best way to batch convert presentations and spreadsheets to Markdown is using a tool with batch processing capabilities that supports PPTX and XLSX formats. This streamlines literature pipelines and research documentation tasks.

Does document conversion to Markdown work with images and audio transcription?

Document conversion to Markdown does work with images and audio transcription. The process uses OCR for images and transcription for audio to generate text, with optional AI-assisted descriptions to enrich the Markdown output.

Can I extract YouTube transcripts and HTML content into Markdown format?

You can extract YouTube transcripts and HTML content into Markdown format through automated document conversion. This targets academic and research documentation tasks by structuring web video and page content into clean text.

Do I need OpenAI to generate AI descriptions during document conversion?

You need OpenAI dependencies if you want to generate AI-assisted descriptions and metadata extraction during document conversion. The core Markdown conversion works independently, but AI modules enrich the output.

When should I not use Markdown for document conversion in research pipelines?

You should not use Markdown for document conversion when your research pipelines require preserving complex original formatting, non-textual layout structures, or proprietary binary elements that cannot be represented in clean structured text.