Skip to content

Getting Started

Publish any markdown file to a shareable URL with a single command.

Install the CLI

Section titled “Install the CLI”
Terminal window
npm install -g mdtolink

This installs both mdtolink and mdtl (shorthand). Both work identically.

Publish your first document

Section titled “Publish your first document”
Terminal window
mdtolink publish README.md


# or use the shorthand:
mdtl README.md

That’s it. You’ll get back a URL you can share with anyone.

Add to your AI agent

Section titled “Add to your AI agent”

Install the MDtoLink skill so your AI agent knows how to publish for you:

Terminal window
npx skills add schedawg74/skills --skill mdtolink

This works with Claude Code, Cursor, Codex, and other agents that support the Agent Skills standard.

Or set up the MCP Server for direct tool access (publish, list, update, delete).

What’s next?

Section titled “What’s next?”
  • Read the CLI Guide for the full command reference
  • Install the Obsidian plugin to publish notes from your vault
  • Set up the MCP Server to use MDtoLink from AI assistants
  • Connect your favorite AI agent — Claude Code, Cursor, Windsurf, and more
  • Create an API key for programmatic access