About convert
convert is a skill that turns a URL or local file into Markdown through the markitdown MCP server. It constructs the appropriate URI, calls the conversion tool, and outputs the resulting Markdown.
Key features
- 01Accept URLs, data URIs, and file paths
- 02Resolve relative paths to absolute paths
- 03Construct a file URI for local files
- 04Call the markitdown conversion tool
- 05Output converted Markdown
Use cases
- 01Convert a web page to Markdown
- 02Convert a local document to Markdown
- 03Convert content supplied as a data URI
MCP support
It uses the markitdown MCP server by calling its convert_to_markdown(uri) tool. It reports when the server is not connected.
Install
Copy the command and run it in a terminal.
npx skills add https:/After installing, type/convertin Claude Code to confirm it loaded.
Details
From the project READMEConvert $ARGUMENTS to Markdown using the markitdown MCP server.
Follow these rules to build the URI:
- If the argument starts with
http://orhttps://ordata:, 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."