| 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
- Run the command with the appropriate flags
- Show the user the summary output
- If there are errors, suggest possible fixes (e.g. corrupted files, missing dependencies)
- Remind the user that re-running is safe — already-converted files are skipped