# mdshare for Obsidian

Share markdown files instantly via [mdshare.live](https://mdshare.live). No login required.

## Install

### From Community Plugins (recommended)

1. In Obsidian: **Settings → Community plugins → Browse**
2. Search for **mdshare**
3. Click **Install**, then **Enable**

### Alternative: BRAT (for pre-release builds)

If you want to track unreleased changes ahead of the Community Plugins listing:

1. Install [BRAT](https://github.com/TfTHacker/obsidian42-brat) from Community Plugins
2. In BRAT settings, click "Add Beta Plugin"
3. Enter: `urbanmorph/obsidian-mdshare`

### Alternative: Manual

1. Download `main.js` and `manifest.json` from the [latest release](https://github.com/urbanmorph/obsidian-mdshare/releases)
2. Create a folder: `<your-vault>/.obsidian/plugins/mdshare/`
3. Copy both files into that folder
4. Enable the plugin in Settings → Community Plugins

## Usage

- **Right-click a `.md` file** in the file explorer → "Share on mdshare"
- **Select text** in the editor → right-click → "Share selection on mdshare"
- **Command palette** (Cmd/Ctrl+P) → "Share current file on mdshare"

The admin URL is automatically copied to your clipboard.

## Network usage

This plugin sends markdown content to `https://mdshare.live/api/documents` to generate shareable links. No account is required. No data is collected or stored beyond the shared document, which expires after 90 days.

## About

[mdshare.live](https://mdshare.live) is a free service for sharing markdown documents. No accounts, no setup. Documents expire after 90 days.