markitdown

Convert PDFs, DOCX, PPTX, XLSX, HTML, CSV, JSON, XML, ZIP, EPUB, YouTube links, images, and audio into Markdown.

4|1|Updated Jun 18, 2025
One-click install
npx skills add https://github.com/HolobiomicsLab/Toolomics --skill markitdown-holobiomicslab
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: markitdown
Source: https://github.com/HolobiomicsLab/Toolomics/tree/main/mcp_host/skills/scientific-skills/scientific-skills/markitdown
Command: npx skills add https://github.com/HolobiomicsLab/Toolomics --skill markitdown-holobiomicslab

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

Convert diverse document formats into Markdown to enable token-efficient AI processing.

Core Features & Use Cases

  • Converts PDFs, DOCX, PPTX, XLSX, HTML, CSV, JSON, XML, ZIP, EPUB, YouTube URLs, and images with OCR and audio transcription into Markdown.
  • Produces Markdown output optimized for AI tooling and knowledge workflows, including frontmatter-ready metadata.
  • Supports a modular design with optional resources (scripts, references, assets) to automate deterministic tasks and provide deeper context.

Quick Start

Convert a sample file to Markdown using the MarkItDown skill.

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 documents to Markdown, this skill processes PDFs, DOCX, and other formats into token-efficient text optimized for AI tooling. It extracts content and generates YAML frontmatter metadata to provide structured context for downstream language models.

Can I extract text from YouTube links and images with OCR?

Yes, you can extract text from YouTube links and images using OCR. The skill also supports audio transcription, converting multimedia sources into Markdown to ensure diverse inputs are accessible for AI processing and research automation.

Does converting XLSX and PPTX to Markdown preserve document structure?

Converting XLSX and PPTX files to Markdown preserves structural content by transforming spreadsheets and presentations into token-efficient text. It ensures a safe, repeatable conversion flow that maintains data integrity for AI workflows.

What is the best way to batch convert EPUB and HTML files to Markdown?

The best way to batch convert EPUB and HTML files is through this skill's modular conversion flow. It transforms various document formats into Markdown with YAML frontmatter, ensuring repeatable and deterministic outputs for AI knowledge workflows.

Do I need OpenAI to transcribe audio and generate AI descriptions?

Yes, you need the OpenAI dependency to transcribe audio and generate AI descriptions. The skill leverages OpenAI models to process multimedia inputs and produce Markdown outputs with optional metadata for research and workflow automation.

Why use YAML frontmatter when converting documents to Markdown?

Using YAML frontmatter when converting documents to Markdown adds structured metadata to the output. This ensures AI tooling can parse context efficiently, enabling token-efficient processing and deeper integration into automated research workflows.