loading…
Browse all
urbanmorph/mdshare
FreeMarkdown collaboration for AI workflows. Share markdown instantly via public links with four permission levels (admin, edit, comment, view), inline comments anc
by urbanmorph
About
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.
README
Share markdown instantly. Free. No login required.
License: MIT MCP GitHub last commit Runs on Cloudflare Workers
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
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
How to install
Add this to claude_desktop_config.json and restart Claude Desktop.
{
"mcpServers": {
"urbanmorph-mdshare": {
"command": "npx",
"args": []
}
}
}