Back to the catalog

io.github.sathya-sankaran/mdshare

Free markdown sharing. Upload, get links, collaborate. No login needed.

Open source Open in the app JSON README (API)

About

Free markdown sharing. Upload, get links, collaborate. No login needed.

Details

Kind
MCP servers
Topic
Files & documents
Publisher
sathya-sankaran
Origin
official
Category
ferramentas
Transport
local
Version
1.4.1
Stars
8
Last push
2026-08-09T13:32:34Z
Repository state
ativo
Language
TypeScript
License
MIT
Added
2026-08-29 04:01:21
Updated
2026-08-29 04:01:21
Origin id
io.github.sathya-sankaran/mdshare

README

# mdshare

Share markdown instantly. Free. No login required.

[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
[![MCP](https://img.shields.io/npm/v/mdshare-mcp?label=MCP&color=indigo)](https://www.npmjs.com/package/mdshare-mcp)
[![GitHub last commit](https://img.shields.io/github/last-commit/urbanmorph/mdshare)](https://github.com/urbanmorph/mdshare)
[![Runs on Cloudflare Workers](https://img.shields.io/badge/Runs%20on-Cloudflare%20Workers-F38020?logo=cloudflare)](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)**

![mdshare editor](public/screenshot.png)

## 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

More