markitdown

Convert PDFs, Office formats, and HTML documents to Markdown.

Updated Apr 11, 2026
One-click install
npx skills add https://github.com/zillafan80-Maxzilla/claw-code-ubuntu-desktopUI --skill markitdown-zillafan80-maxzilla
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: markitdown
Source: https://github.com/zillafan80-Maxzilla/claw-code-ubuntu-desktopUI/tree/main/payload/claw-code/.claw/skills/markitdown
Command: npx skills add https://github.com/zillafan80-Maxzilla/claw-code-ubuntu-desktopUI --skill markitdown-zillafan80-maxzilla

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This skill provides a robust, reusable pipeline for converting a wide range of documents into Markdown, enabling consistent extraction, formatting, and downstream AI processing.

Core Features & Use Cases

  • Automated document-to-Markdown conversion for PDFs, Word, Excel, PowerPoint, HTML, and other formats.
  • Preserves structure, tables, lists, links, and images; supports plugin-based OCR and custom style maps.
  • Use Case: prepare large document collections for indexing, search, and AI-assisted analysis by generating clean Markdown outputs.

Quick Start

Feed a document to MarkItDown and receive a clean Markdown version.

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 Office documents to Markdown for AI analysis?

To convert PDF and Office documents to Markdown for AI analysis, you feed files like PDFs, Word, Excel, and PowerPoint into the conversion pipeline. The engine processes the content and outputs clean, structured Markdown text.

Does document to Markdown conversion preserve tables and lists from xlsx and pptx files?

Yes, converting xlsx and pptx files to Markdown preserves structural elements like tables, lists, links, and images. The extraction process maintains document readability and formatting for downstream indexing.

What's the best way to extract text from HTML and PDF files for search indexing?

The best way to extract text from HTML and PDF files for search indexing is using an automated conversion pipeline. It transforms diverse content sources into consistent Markdown, enabling efficient search and retrieval.

Can I use OCR plugins to convert scanned PDFs to Markdown?

Yes, you can use plugin-based OCR to convert scanned PDFs to Markdown. The conversion engine supports optional OCR plugins to extract text from images, ensuring accurate content extraction from diverse documents.

Why should I convert docx and xlsx files to Markdown instead of plain text extraction?

Converting docx and xlsx files to Markdown instead of plain text extraction preserves structural formatting like tables and lists. This structural readability is crucial for accurate AI-assisted analysis and document search.

Are there limitations when converting large PowerPoint files to Markdown?

While the engine handles diverse document types including PowerPoint, complex PPTX files with heavy multimedia may require custom style maps or OCR plugins. The pipeline focuses on preserving text structure and readability for indexing.