🎁 Get the FREE AI Skills Starter Guide β€” Subscribe β†’
BytesAgainBytesAgain
BytesAgain β€Ί Skills β€Ί Markdown Converter
πŸ¦€ ClawHub

Markdown Converter

by @steipete

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.

Versionv1.0.0
Downloads42,266
Installs481
Stars⭐ 177
Comments1
#data#writing#video#audio#legal
TERMINAL
clawhub install markdown-converter

πŸ“– About This Skill

name: markdown-converter description: 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.

Markdown Converter

Convert files to Markdown using uvx markitdown β€” no installation required.

Basic Usage

# 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

    -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

    # 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

    • πŸ’‘ Examples

    # 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/"

    βš™οΈ Configuration

    -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

    πŸ“‹ Tips & Best Practices

  • 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