markdown-converter
by steipete
PDF & DocumentsBrief
Convert documents and files to Markdown.
Description
What This Skill Does
Converts PDF, Word, PowerPoint, Excel, HTML, CSV, JSON, XML, images, audio, ZIP archives, YouTube URLs, and EPubs to Markdown. Runs via `uvx markitdown` with no prior installation needed. Output preserves document structure including headings, tables, and lists.
Handles a wider range of input formats than most converters, including media files with OCR and audio transcription, without requiring any local installation.
When to Use It
- Preparing PDF reports for LLM ingestion
- Extracting readable text from PowerPoint slides
- Converting Excel spreadsheets to Markdown tables for analysis
- Transcribing audio files to text output
- Pulling YouTube video transcripts into Markdown
Example Workflow
User asks: Convert report.pdf to Markdown
- 1
Accept the PDF file path from the user
- 2
Run
uvx markitdown report.pdf -o output.md - 3
Read and return the generated Markdown content
Markdown file with preserved headings, tables, and structure from the original PDF
Requirements
- Azure Document Intelligence endpoint and API key (only needed for enhanced PDF extraction with the -d flag)
Installation
clawhub install steipete/markdown-converterRun the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.