markitdownlisted

# markitdown Convert a source file to Markdown, save it next to the source, and — only with explicit approval — clean up formatting artifacts left over from the conversion. This skill wraps [markitdown](https://github.com/microsoft/markitdown), Microsoft's open-source CLI for converting files to Markdown — all credit for the actual conversion goes to that project. This skill only adds the install-and-fix-up workflow around it. ## Step 1: Resolve the input The input may arrive as an attached file, a bare filename, or a full path. - If it's a full path or attachment, use it directly. - If it's a bare filename, check the current directory first, then common locations like `~/Downloads` and `~/Desktop`. If you find more than one match or none, ask the user rather than guessing — picking the wrong file is worse than asking a quick question. ## Step 2: Make sure markitdown is installed Run `scripts/ensure_markitdown.sh`. It checks whether `markitdown` is on PATH, already installed at `~/.local/bin/markitdown`, or importable as a Python module even without a console-script entrypoint (covers venvs, system package managers, and non-standard pip installs) — and only installs it if none of those find it. No need to ask before installing. This mirrors how it was set up the first time, so re-running it on a machine that already has markitdown is a fast no-op. The install path is platform-aware: - **macOS** uses Homebrew (`python@3.12`, `pipx`), the reliable standard there.