io.github.sathya-sankaran/mdshare
Free markdown sharing. Upload, get links, collaborate. No login needed.
What can you do with io.github.sathya-sankaran/mdshare?
- 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
Install
Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).
mdshare-mcpclaude mcp add mdshare -- npx -y mdshare-mcp@1.5.0
{
"mcpServers": {
"mdshare": {
"command": "npx",
"args": [
"-y",
"mdshare-mcp@1.5.0"
]
}
}
}
Documentation
From the project's README on GitHub, refreshed weekly. Links open on GitHub.
Contents
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
Frequently asked questions
What is io.github.sathya-sankaran/mdshare?
Free markdown sharing. Upload, get links, collaborate. No login needed.
How do I install io.github.sathya-sankaran/mdshare?
It runs on your machine. In Claude Code: claude mcp add mdshare -- npx -y mdshare-mcp@1.5.0. For other clients, paste the JSON configuration from this page into their MCP settings.
Does io.github.sathya-sankaran/mdshare need an API key?
Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.
Is io.github.sathya-sankaran/mdshare open source?
Yes. Its code is on GitHub under the MIT license.
Who maintains io.github.sathya-sankaran/mdshare?
It is published by urbanmorph. AI.tn lists it but does not maintain or endorse it.
From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.