Skip to content

Markdown Converter

Verified

Convert documents and files to Markdown using markitdown. Use when converting PDF, Word (.docx), PowerPoint (.pptx), Excel (.xlsx, .xls), HTML, CSV, JSON, XML, images (with EXIF/OCR), audio (with transcription), ZIP archives, YouTube URLs, or EPubs to Markdown format for LLM processing or text analysis.

12,055

Install

Claude Code

Add to .claude/skills/

About This Skill

# Markdown Converter

Convert files to Markdown using `uvx markitdown` — no installation required.

Basic Usage

```bash # Convert to stdout uvx markitdown input.pdf

# Save to file uvx markitdown input.pdf -o output.md uvx markitdown input.docx > output.md

# From stdin cat input.pdf | uvx markitdown ```

Supported Formats

  • Documents: PDF, Word (.docx), PowerPoint (.pptx), Excel (.xlsx, .xls)
  • Web/Data: HTML, CSV, JSON, XML
  • Media: Images (EXIF + OCR), Audio (EXIF + transcription)
  • Other: ZIP (iterates contents), YouTube URLs, EPub

Options

```bash -o OUTPUT # Output file -x EXTENSION # Hint file extension (for stdin) -m MIME_TYPE # Hint MIME type -c CHARSET # Hint charset (e.g., UTF-8) -d # Use Azure Document Intelligence -e ENDPOINT # Document Intelligence endpoint --use-plugins # Enable 3rd-party plugins --list-plugins # Show installed plugins ```

Examples

```bash # Convert Word document uvx markitdown report.docx -o report.md

# Convert Excel spreadsheet uvx markitdown data.xlsx > data.md

# Convert PowerPoint presentation uvx markitdown slides.pptx -o slides.md

# Convert with file type hint (for stdin) cat document | uvx markitdown -x .pdf > output.md

# Use Azure Document Intelligence for better PDF extraction uvx markitdown scan.pdf -d -e "https://your-resource.cognitiveservices.azure.com/" ```

Notes

  • Output preserves document structure: headings, tables, lists, links
  • First run caches dependencies; subsequent runs are faster
  • For complex PDFs with poor extraction, use `-d` with Azure Document Intelligence

Use Cases

  • Convert PDF, Word, PowerPoint, and Excel files to Markdown format
  • Transform HTML, CSV, JSON, and XML documents into clean Markdown
  • Extract text from images with OCR and convert to Markdown
  • Process audio files with transcription into Markdown format
  • Build document ingestion pipelines that normalize content to Markdown

Pros & Cons

Pros

  • + Compatible with multiple platforms including claude-code, openclaw
  • + Well-documented with detailed usage instructions and examples
  • + Strong community adoption with a large number of downloads

Cons

  • - No built-in analytics or usage metrics dashboard
  • - Configuration may require familiarity with ai & machine learning concepts

Frequently Asked Questions

What does Markdown Converter do?

Convert documents and files to Markdown using markitdown. Use when converting PDF, Word (.docx), PowerPoint (.pptx), Excel (.xlsx, .xls), HTML, CSV, JSON, XML, images (with EXIF/OCR), audio (with transcription), ZIP archives, YouTube URLs, or EPubs to Markdown format for LLM processing or text analysis.

What platforms support Markdown Converter?

Markdown Converter is available on Claude Code, OpenClaw.

What are the use cases for Markdown Converter?

Convert PDF, Word, PowerPoint, and Excel files to Markdown format. Transform HTML, CSV, JSON, and XML documents into clean Markdown. Extract text from images with OCR and convert to Markdown.

Stay Updated on Agent Skills

Get weekly curated skills + safety alerts