Convert to Markdown

Convert various file formats to Markdown using markitdown MCP, optimized for AI readability.

Arguments

• files

  : Input files or directories to convert (required)

Options

• --recursive

  ,

  -r

  : Process subdirectories recursively

• --filter <types>

  : Filter by file types (e.g., pdf,docx,xlsx)

• --combine

  ,

  -c

  : Combine multiple files into one markdown file

• --toc

  : Generate table of contents

• --metadata

  ,

  -m

  : Include file metadata in output

• --ai-optimize

  : Optimize output for AI reading

• --output

  ,

  -o <path>

  : Specify output directory or file

• --verbose

  ,

  -v

  : Show detailed progress

Examples

# Convert single file
/convert-to-md document.pdf

# Convert multiple files with AI optimization
/convert-to-md --ai-optimize file1.docx file2.xlsx

# Recursively convert directory with filtering
/convert-to-md --recursive --filter pdf,docx ./documents

# Combine files into one markdown with TOC
/convert-to-md --combine --toc *.pdf -o combined.md

Workflow

1. Parse arguments and validate input files
2. Get file list based on patterns and filters
3. For each file:
   • Call

     mcp__markitdown__convert_to_markdown

     with file URI
   • Apply AI optimization if enabled
   • Save to output location
4. If

   --combine

   , merge all outputs with optional TOC
5. Report summary (successful/failed counts)

AI Optimization Features

When

--ai-optimize

is enabled:

• Add file context headers (filename, original format)
• Add structure hints (headers, code blocks, tables)
• Clean up excessive whitespace
• Add reading notes for long documents