markitdown

name	markitdown
description	Convert documents (PDF, Word, PowerPoint, Excel) in the vault to Markdown. Use when the user asks to convert documents, make files searchable, or index non-markdown files.
argument-hint	["--dry-run"]
disable-model-invocation	true

Convert non-markdown documents in the vault to sibling .md files using markitdown.

Usage

Run the conversion:

pixi run markitdown

Preview what would be converted (no changes):

pixi run markitdown --dry-run

If the user passes $ARGUMENTS, forward them:

pixi run vault-tools markitdown $ARGUMENTS

Behavior

1. Run the command with the appropriate flags
2. Show the user the summary output
3. If there are errors, suggest possible fixes (e.g. corrupted files, missing dependencies)
4. Remind the user that re-running is safe — already-converted files are skipped