urbanmorph/mdshare
📇 ☁️ - Markdown collaboration for AI workflows. Share markdown instantly via public links with four permission levels (admin, edit, comment, view), inline comments anchored to text, real-time WebSocket sync, and version history. Free, no login. npx mdshare-mcp lets AI agents read docs, review comments, incorporate feedback, and resolve threads — the full review loop without copy-pasting between tools.
Quick Install
{
"mcpServers": {
"urbanmorph-mdshare": {
"command": "npx",
"args": [
"-y",
"urbanmorph-mdshare"
]
}
}
}Using an AI coding agent (Claude Code, Cursor, etc.)? Copy a ready-made prompt that tells it to fetch the setup instructions and install this server for you.
Documentation Overview
mdshare
Share markdown instantly. Free. No login required.
mdshare.live | API Docs | VS Code | Obsidian
Quick Start
Paste markdown at mdshare.live, start from a blank page, or upload via curl:
curl -X POST https://mdshare.live/api/documents \
-H "Content-Type: text/markdown" \
--data-binary @your-file.md
You get back an admin URL. Share it, or generate links with different permissions.
Features
- Four permission levels -- Admin, Edit, Comment, View -- each with its own shareable link
- WYSIWYG editor -- formatting toolbar, tables, code blocks, keyboard shortcuts
- Inline comments -- anchor comments to specific text, reply, and resolve
- Real-time sync -- WebSocket collaboration, live presence indicators
- Link management -- revoke links instantly, optional expiry, 50-link cap per document
- VS Code & Obsidian plugins -- share markdown directly from your editor
- API & MCP -- REST API + MCP server for Claude, ChatGPT, Gemini, Cursor, and Windsurf
MCP Server
npx mdshare-mcp
Say "upload my-notes.md to mdshare" in any MCP-compatible AI tool. The MCP server reads files directly from disk (no echoing through the conversation), so it's fast even for large markdown files. Setup guide
Claude Code Plugin
/plugin marketplace add urbanmorph/mdshare
/plugin install mdshare@urbanmorph
Wraps the MCP server above with a single skill — Claude reaches for it on phrases like "share this markdown". Setup guide · source
Cursor Plugin
Listed on Cursor Directory — click "Add to Cursor" on the listing page. Same MCP server, same skill as the Claude Code plugin. Source
Obsidian Plugin
Listed in the Obsidian Community Plugins directory — install via Settings → Community Plugins → Browse → search "mdshare". Right-click any .md file in your vault to share it; admin URL is copied to your clipboard. Source
Tech Stack
| Component | Technology |
|---|---|
| Framework | Astro 5 |
| UI | React (as Astro islands) |
| Hosting | Cloudflare Workers (native) |
| Database | Cloudflare D1 (SQLite) |
| Real-time | Cloudflare Durable Objects (WebSocket) |
| Editor | Tiptap + tiptap-markdown |
| Styling | Tailwind CSS v4 |
| CI/CD | GitHub Actions |
Local Development
git clone https://github.com/urbanmorph/mdshare.git
cd mdshare
npm install
# Create a .dev.vars file with your Cloudflare API token
echo "CLOUDFLARE_API_TOKEN=your_token" > .dev.vars
# Apply local D1 migrations
npx wrangler d1 migrations apply mdshare-db --local
# Start dev server
npm run dev -- -p 3737
Contributing
Issues and PRs welcome. Please open an issue first to discuss significant changes.
License
MIT