markitdown-skill

Converts PDFs, Word, HTML, images and transcripts to Markdown via MarkItDown CLI or Python API.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

OpenClaw agents rely on MarkItDown to convert a variety of documents into readable Markdown for analysis, documentation, and knowledge workflows. This Skill provides comprehensive guidance, usage patterns, and utilities to streamline conversion using MarkItDown.

Core Features & Use Cases

  • Documentation and usage guides for Microsoft's MarkItDown library, including a batch conversion script.
  • CLI-based and Python API-based workflows for PDFs, Word, PowerPoint, Excel, HTML, images (OCR), and transcripts.
  • Batch processing and integration-ready examples to plug into LangChain, FastAPI, or other tooling.

Quick Start

Run markitdown on a sample document to generate Markdown output.

Frequently Asked Questions about markitdown-skill

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

FAQPage Schema
How do I convert PDF and Word documents to Markdown in bulk?

You can convert PDFs and Word documents to Markdown using the MarkItDown CLI or the included batch_convert.py script, which processes multiple files into clean Markdown output for knowledge workflows.

Can I use OpenAI to extract text from images when converting documents to Markdown?

Yes, MarkItDown supports an optional OpenAI integration to perform OCR on images and transcripts, converting them into Markdown-formatted output alongside standard document formats.

Does this document conversion approach support HTML pages and Excel files?

Yes, this approach supports converting HTML pages, Excel spreadsheets, PowerPoint, and Word docs into readable Markdown for analysis and documentation workflows.

What is the best way to integrate document to Markdown conversion into a Python API?

The best way to integrate document to Markdown conversion into a Python API is using the provided API-based workflows and integration-ready examples that plug directly into frameworks like LangChain or FastAPI.

Why do I need to convert documents to Markdown for knowledge automation workflows?

Converting documents to Markdown standardizes varied formats like PDFs and HTML into clean text, enabling agents and tools to analyze, document, and automate knowledge tasks efficiently.