mdshare

Share markdown instantly. Free. No login required.

mdshare.live | API Docs | VS Code | Obsidian

mdshare editor

Quick Start

Paste markdown at mdshare.live, start from a blank page, or upload via curl:

Terminal

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.

Full API documentation

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

Terminal

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

Code

/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

bash

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