markitdown-cli

Convert local documents, web URLs, and piped stdin content into Markdown.

8|12|Updated Sep 19, 2025
One-click install
npx skills add https://github.com/xpert-ai/xpert-plugins --skill markitdown-cli
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: markitdown-cli
Source: https://github.com/xpert-ai/xpert-plugins/tree/main/xpertai/middlewares/markitdown/src/lib/skills
Command: npx skills add https://github.com/xpert-ai/xpert-plugins --skill markitdown-cli

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Manually converting PDFs, Office documents, web pages, and piped content into editable Markdown is time-consuming and error-prone. This Skill eliminates that hassle by automating format conversion for dozens of common file types and input sources.

Core Features & Use Cases

  • Multi-format Support: Convert PDFs, DOCX, PPTX, XLSX, HTML, CSV, archives, and more to Markdown, with optional OCR and Azure Document Intelligence for scanned files.
  • Flexible Input Handling: Process local files, fetchable URLs, and piped stdin content, with type hints for ambiguous inputs.
  • Batch Processing: Convert entire folders of files with simple shell commands. For example, turn a directory of quarterly reports in PDF and DOCX format into Markdown for easy editing and sharing.

Quick Start

Use the markitdown-cli skill to convert your 'quarterly_report.pdf' file to Markdown and save it as 'quarterly_report.md'.

Frequently Asked Questions about markitdown-cli

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

FAQPage Schema
How do I convert a PDF to Markdown format?

You can convert a PDF to Markdown by processing local files, web URLs, or piped stdin content. The tool standardizes the PDF content into editable Markdown format, with optional OCR support for scanned documents.

Can I batch convert an entire folder of Office documents to Markdown?

Yes, you can batch convert an entire directory of files like DOCX, PPTX, and XLSX into Markdown. This allows you to process multiple documents in a folder using simple shell commands for automated workflows.

What is the best way to convert web URLs to Markdown?

The best way to convert web URLs to Markdown is by passing the fetchable URL directly to the conversion process. The tool fetches the HTML page content and standardizes it into Markdown format in seconds.

Does converting scanned PDFs to Markdown require OCR?

Yes, scanned PDFs require OCR to extract text during Markdown conversion. The tool supports optional OCR capabilities and Azure Document Intelligence integration to process scanned documents accurately.

How do I process piped stdin content into Markdown?

You can process piped stdin content into Markdown by streaming the input data directly into the conversion tool. This allows seamless integration into automated, scriptable document transformation pipelines.