markitdown

Convert PDFs, Word documents, and spreadsheets into Markdown with YAML frontmatter.

33.0k|3.2k|Updated Oct 19, 2025
One-click install
npx skills add https://github.com/K-Dense-AI/scientific-agent-skills --skill markitdown-k-dense-ai
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: markitdown
Source: https://github.com/K-Dense-AI/scientific-agent-skills/tree/main/scientific-skills/markitdown
Command: npx skills add https://github.com/K-Dense-AI/scientific-agent-skills --skill markitdown-k-dense-ai

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

MarkItDown automates the transformation of a wide range of documents into Markdown, delivering token-efficient, readable outputs for AI workflows, reviews, and documentation.

Core Features & Use Cases

  • Converts PDFs, Word documents, PowerPoints, Excel spreadsheets, HTML pages, YouTube transcripts, images with OCR, and more into Markdown.
  • Supports AI-enhanced descriptions for images, optional Azure Document Intelligence integration, and batch processing with a plugin system.
  • Use case: convert a research paper, dataset, or presentation into Markdown for analysis, note-taking, or integration with AI assistants.

Quick Start

Convert a sample document, such as research_paper.pdf, to Markdown using MarkItDown.

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 PowerPoint files to Markdown for AI workflows?

To convert PDF and PowerPoint files to Markdown for AI workflows, use a document conversion tool that extracts text from PDFs, DOCX, PPTX, and HTML pages, outputting clean, token-efficient Markdown text.

Can I extract text from images using OCR and generate AI descriptions?

Yes, you can extract text from images using OCR and generate AI descriptions. The conversion process supports optical character recognition for images and optional AI-enhanced descriptions to improve text extraction accuracy.

Does converting documents to Markdown support batch processing and plugins?

Yes, converting documents to Markdown supports batch processing and plugins. You can process multiple files simultaneously and extend functionality through a plugin system to handle various formats like spreadsheets and research papers.

Do I need Azure Document Intelligence to parse research papers and spreadsheets?

You do not need Azure Document Intelligence to parse research papers and spreadsheets. Azure Document Intelligence is an optional enhancement for complex document parsing, while standard conversion handles basic formats natively.

What is the best way to convert Excel spreadsheets and HTML pages into clean text?

The best way to convert Excel spreadsheets and HTML pages into clean text is using a dedicated document conversion tool that outputs Markdown. This ensures the extracted text is readable, structured, and ready for AI analysis or archival.