markitdown

Convert PDF, Word, PowerPoint, Excel, HTML, images, and audio to Markdown.

Updated Jul 10, 2023
One-click install
npx skills add https://github.com/iamtatsuki05/dotfiles --skill markitdown-iamtatsuki05
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: markitdown
Source: https://github.com/iamtatsuki05/dotfiles/tree/main/dotfiles/.agent/skills/markitdown
Command: npx skills add https://github.com/iamtatsuki05/dotfiles --skill markitdown-iamtatsuki05

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Converts diverse source formats into Markdown text to simplify documentation and content reuse.

Core Features & Use Cases

  • Multi-format conversion: PDF, Word, PowerPoint, Excel/CSV, HTML/URL, images (OCR), and audio (transcription) with optional full support via markitdown[all].
  • CLI and Python API access: perform conversions from shell or code and integrate into automation pipelines.
  • Install guidance and error handling: checks installation, guides users to install dependencies, and provides robust fallbacks for common formats.

Quick Start

Convert a sample input file to Markdown by running markitdown on your file, for example converting report.pdf to report.md.

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 documentation workflows?

To convert a PDF to Markdown, you can run markitdown on your file, such as transforming report.pdf into report.md. This simplifies documentation workflows by turning diverse source formats into reusable Markdown text.

Can I extract text from images and audio into Markdown?

Yes, you can extract text from images using OCR and transcribe audio into Markdown. Enabling optional full support via markitdown[all] unlocks these multi-format conversion capabilities for your documentation.

What file formats are supported for converting to Markdown?

Supported source formats include PDF, Word, PowerPoint, Excel, CSV, HTML, URLs, images, and audio. Converting these diverse formats into Markdown simplifies documentation and content reuse.

Does markitdown work with both CLI and Python API for automation?

Yes, markitdown supports both CLI and Python API access. You can perform conversions from the shell or integrate the conversion logic directly into Python automation pipelines.

What happens if I am missing dependencies for a specific file conversion?

The tool checks installation and guides users to install missing dependencies. It provides robust fallbacks and handles errors gracefully, ensuring common formats can still be processed.

What is the best way to convert Word and Excel files to Markdown?

The best way to convert Word and Excel files to Markdown is using markitdown, which transforms documents and spreadsheets into reusable text. You can run it via CLI or Python API.