# Convert

> Converts a file path or URL to Markdown using markitdown. Usage: /convert <file-path or URL>

- Skill: `heyman333/convert` (Agent Skill)
- Install (CLI): `npx skillmds@latest add heyman333/convert`
- Raw SKILL.md: https://api.skillmd.com/api/skills/heyman333/convert/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing
- Author: heyman333 (https://skillmd.com/u/heyman333)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/heyman333/convert

---


Convert `$ARGUMENTS` to Markdown using the markitdown MCP server.

Follow these rules to build the URI:
- If the argument starts with `http://` or `https://` or `data:`, use it as-is.
- If the argument is a local file path (absolute or relative), convert it to a `file://` URI.
  - Resolve relative paths to absolute using the current working directory.
  - Example: `/Users/me/docs/report.pdf` → `file:///Users/me/docs/report.pdf`

Then call the `convert_to_markdown(uri)` tool from the markitdown MCP server with the constructed URI.

Output the resulting Markdown content directly.

If the `convert_to_markdown` tool is not available, print:
"⚠️ markitdown MCP server is not connected. Please run /markitdown-setup first, then restart Claude Code."