https://github.com/urbanmorph/mdshare
Share and collaborate on local markdown files via shareable links
https://github.com/urbanmorph/mdshare
Last synced: 14 days ago
JSON representation
Share and collaborate on local markdown files via shareable links
- Host: GitHub
- URL: https://github.com/urbanmorph/mdshare
- Owner: urbanmorph
- License: mit
- Created: 2026-04-01T12:33:08.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2026-05-19T18:12:05.000Z (about 2 months ago)
- Last Synced: 2026-05-19T21:51:36.404Z (about 2 months ago)
- Language: TypeScript
- Size: 3.82 MB
- Stars: 2
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Agents: AGENTS.md
Awesome Lists containing this project
README
# mdshare
Share markdown instantly. Free. No login required.
[](LICENSE)
[](https://www.npmjs.com/package/mdshare-mcp)
[](https://github.com/urbanmorph/mdshare)
[](https://mdshare.live)
**[mdshare.live](https://mdshare.live)** | **[API Docs](https://mdshare.live/docs)** | **[VS Code](https://mdshare.live/docs#vscode)** | **[Obsidian](https://mdshare.live/docs#obsidian)**
## Quick Start
Paste markdown at [mdshare.live](https://mdshare.live), start from a blank page, or upload via curl:
```bash
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](https://mdshare.live/docs)
## 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
```bash
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](https://mdshare.live/share-markdown-with-ai)
## 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](https://mdshare.live/install-mdshare-plugin) · [source](plugins/claude-code/)
## Cursor Plugin
Listed on [Cursor Directory](https://cursor.directory/plugins/mdshare) — click "Add to Cursor" on the listing page. Same MCP server, same skill as the Claude Code plugin. [Source](plugins/mdshare-cursor/)
## Obsidian Plugin
Listed in the [Obsidian Community Plugins directory](https://community.obsidian.md/plugins/mdshare) — 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](https://github.com/urbanmorph/obsidian-mdshare)
## 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