markitdown

Convert PDF, DOCX, PPTX, XLSX, and other files to Markdown.

1|Updated Mar 20, 2026
One-click install
npx skills add https://github.com/kk580kk/Investment-analysis-reports --skill markitdown-kk580kk
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: markitdown
Source: https://github.com/kk580kk/Investment-analysis-reports/tree/main/skills/markitdown
Command: npx skills add https://github.com/kk580kk/Investment-analysis-reports --skill markitdown-kk580kk

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires markitdown, openai, tesseract, pypdf, pdfplumber, pdf2image, and includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

This Skill converts various file formats to Markdown, enhancing visual communication and making documents more accessible for language models.

Core Features & Use Cases

  • File Conversion: Converts PDF, DOCX, PPTX, XLSX, images, audio, HTML, CSV, JSON, XML, ZIP, YouTube URLs, and EPubs to Markdown.
  • AI-Enhanced Descriptions: Generates AI-powered image descriptions and speech transcriptions for improved accessibility.
  • Use Case: Convert a complex scientific paper to Markdown, with AI-enhanced image descriptions to make it more accessible to language models.

Quick Start

Run the markitdown skill with the file 'research_paper.pdf'.

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 language models?

To convert a PDF to Markdown, this tool uses the MarkItDown library and pdfplumber to extract text into an LLM-friendly format. It transforms documents into accessible Markdown text suitable for language model ingestion.

Can I extract text from images using OCR and generate Markdown?

Yes, you can extract text from images using OCR to generate Markdown. It utilizes the Tesseract engine to recognize text within image files and converts the extracted content into structured Markdown format.

Does this tool support converting DOCX, PPTX, and XLSX files to Markdown?

Yes, it supports converting DOCX, PPTX, and XLSX files to Markdown. It handles Office documents, HTML, CSV, JSON, XML, ZIP, and EPubs for comprehensive file conversion into LLM-friendly text.

What is the best way to transcribe audio files into Markdown text?

The best way to transcribe audio into Markdown text is using this tool's AI-enhanced speech transcription feature. It processes audio files and outputs written Markdown content for documentation.

How do AI image descriptions work when converting scientific papers to Markdown?

AI image descriptions work by analyzing visual content in documents like scientific papers and generating textual explanations. It embeds these AI-generated descriptions directly into the final Markdown output.

Do I need to install Tesseract and MarkItDown to convert files to Markdown?

Yes, you need Tesseract and MarkItDown installed along with associated Python packages like pypdf and pdf2image. These dependencies are required to execute file conversion and OCR processing successfully.