markitdown

Convert local files and URLs into clean Markdown.

Updated Mar 28, 2026
One-click install
npx skills add https://github.com/MisLink/agentry --skill markitdown-mislink
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: markitdown
Source: https://github.com/MisLink/agentry/tree/main/agents/.agents/skills/markitdown
Command: npx skills add https://github.com/MisLink/agentry --skill markitdown-mislink

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Markitdown automates converting diverse content—PDFs, Word docs, HTML pages, images (with OCR/EXIF), audio transcripts, ZIP archives, RSS feeds, YouTube transcripts, and more—into readable Markdown, eliminating tedious manual extraction and reformatting for AI workflows.

Core Features & Use Cases

  • Automates cross-format content conversion (PDF, DOCX, PPTX, XLSX, EPUB, HTML, ZIP, images, audio, YouTube transcripts, RSS feeds) into clean Markdown suitable for reading, summarization, and analysis.
  • Supports both local files and URLs with intelligent fallbacks to web_fetch when parsing is noisy or non-textual.
  • Preserves structure, references, and key metadata to enable reliable downstream tasks like research, reporting, and knowledge capture.

Quick Start

Convert a local file or URL 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 a PDF to Markdown for AI analysis?

Markitdown converts local PDF files or URLs into clean Markdown suitable for AI-friendly reading and analysis. It preserves structure and key metadata to enable reliable downstream tasks like research and summarization.

Can I extract YouTube transcripts and RSS feeds into Markdown?

Markitdown extracts YouTube transcripts and RSS feeds into Markdown, transforming dynamic web content into readable text. It applies a deterministic workflow with intelligent fallbacks to web_fetch when parsing is noisy or non-textual.

What is the best way to convert DOCX, PPTX, and XLSX files for AI workflows?

Markitdown is the best way to convert DOCX, PPTX, and XLSX files for AI workflows because it automates cross-format content conversion into clean Markdown. It eliminates tedious manual extraction and reformatting while preserving document structure.

Does this content conversion tool support extracting text from images and audio?

Yes, this content conversion tool supports extracting text from images via OCR and EXIF metadata, as well as generating audio transcripts. It converts these diverse formats into clean Markdown suitable for reading and analysis.

How do I process HTML pages and ZIP archives into Markdown?

You can process HTML pages and ZIP archives by providing their local file paths or URLs to markitdown. It converts these diverse content types into clean Markdown, applying fallbacks to web_fetch when appropriate to handle noisy or non-textual parsing.

What are the limitations when converting EPUB and web content to Markdown?

When converting EPUB and web content to Markdown, limitations may arise from noisy or non-textual parsing, though markitdown applies intelligent fallbacks to web_fetch to mitigate this. It is designed for deterministic cross-format conversion but relies on the original content's extractable text.