MarkItDown

SkillFiles & storage

A Python utility for converting various file formats (PDF, Word, Excel, PowerPoint, etc.) to Markdown. Use this skill to install and use MarkItDown for document conversion.

Instructions available. Your AI can read the instructions. Execution depends on the setup they require.

Account requirements not reviewed. Check the skill instructions before use; ahel provides instructions and does not run this skill.

Add ahel to your AI once: Claude, ChatGPT, Cursor, Claude Code or Codex. Then ask it to use this.

Then ask your AI: use the MarkItDown skill

What this skill tells your AI

The instructions your AI receives, as published by myths-labs/muse in skills/toolkit/markitdown/SKILL.md and read by ahel’s review.

MarkItDown is a lightweight Python utility by Microsoft for converting various files to Markdown for use with LLMs.

Capabilities

Converts the following formats to Markdown:

PDF
PowerPoint (.pptx)
Word (.docx)
Excel (.xlsx)
Images (EXIF & OCR)
Audio (Transcription)
HTML
Text formats (CSV, JSON, XML)
YouTube URLs
ZIP files

Installation

To use MarkItDown, you first need to install it. It requires Python 3.10+.

pip install "markitdown[all]"

Usage

Command Line

Convert a file and print to stdout:

markitdown path-to-file.pdf

Convert a file and save to output:

markitdown path-to-file.pdf -o document.md

Pipe content:

cat path-to-file.pdf | markitdown

Python API

from markitdown import MarkItDown

md = MarkItDown()
result = md.convert("test.xlsx")
print(result.text_content)

Microsoft Document Intelligence

For better PDF extraction, use Azure Document Intelligence:

markitdown path-to-file.pdf -o document.md -d -e "<endpoint>"

Signals

GitHub stars: 35
Forks: 4
Last commit: Sep 2026
Hacker News mentions: 1

ahel review

K1binfo
installs-packages

Automated review, not a security audit. Ruleset v1+k2.

Advanced

Item type: skill
Key: markitdown-myths-labs
Source: github.com/myths-labs/muse

github.com/myths-labs/muse