markitdown

Convert PDFs, DOCX, PPTX, XLSX, HTML, EPUB, CSV, JSON, and images into Markdown.

16|7|Updated Nov 20, 2025
One-click install
npx skills add https://github.com/jackspace/ClaudeSkillz --skill markitdown
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: markitdown
Source: https://github.com/jackspace/ClaudeSkillz/tree/main/skills/scientific-pkg-markitdown
Command: npx skills add https://github.com/jackspace/ClaudeSkillz --skill markitdown

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill automates the complex process of converting diverse file formats (documents, media, web content, structured data) into clean, token-efficient Markdown. It eliminates manual data extraction and reformatting, making content instantly usable for Large Language Models (LLMs) for analysis, RAG systems, or content generation.

Core Features & Use Cases

  • Universal Document Conversion: Convert PDFs, Word (DOCX), PowerPoint (PPTX), and Excel (XLSX) files into structured Markdown, preserving headings, lists, and tables.
  • Media & Web Content Extraction: Perform OCR on images, transcribe audio files, extract YouTube video transcripts, and convert HTML/EPUB into Markdown.
  • Structured Data to Markdown: Transform CSV, JSON, and XML data into readable Markdown tables, ideal for quick LLM consumption.
  • Use Case: You have a folder full of research papers (PDFs), meeting notes (DOCX), and presentation slides (PPTX). Use MarkItDown to batch convert all of them into a single, coherent Markdown document, then feed it to an LLM for summarization or to answer specific questions, saving hours of manual reading and note-taking.

Quick Start

Convert the attached 'report.pdf' file into Markdown format and display the text content.

Frequently Asked Questions about markitdown

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I convert PDF documents into Markdown for LLM analysis?

Convert PDFs to Markdown by extracting text, tables, and structure while preserving formatting. This Skill processes PDFs into token-efficient Markdown suitable for feeding into language models, RAG systems, or content analysis without manual reformatting.

Can I batch convert multiple document formats at once for RAG pipelines?

Yes. Batch processing converts entire folders of mixed formats—PDFs, DOCX, PPTX, XLSX, HTML, images, audio files—into Markdown simultaneously. This streamlines RAG pipeline preparation by handling diverse inputs in a single operation.

What file formats can be converted to Markdown?

Supported formats include PDFs, DOCX, PPTX, XLSX, HTML, EPUB, CSV, JSON, images (with OCR), audio transcripts, YouTube transcripts, and web content. All convert to structured Markdown preserving headings, lists, tables, and hyperlinks.

How do I extract text from images and audio files into usable formats?

This Skill performs OCR on images and transcribes audio files, converting both into clean Markdown text. Extracted content integrates seamlessly with document batches for unified LLM-ready data preparation.

Does document structure get preserved when converting to Markdown?

Yes. Conversion maintains document structure including headings, lists, tables, hyperlinks, and metadata. Output is optimized for LLM consumption with efficient token usage and logical formatting intact.

Why convert to Markdown instead of keeping original file formats?

Markdown is universally readable, token-efficient for LLMs, and eliminates format-specific parsing complexity. Converting PDFs, Word docs, and other formats to Markdown creates a single standardized input for analysis, RAG systems, and content generation.