# yeet.md

> Paste Markdown, get a public shareable link. Free, no account, immutable snapshots.

## What is yeet.md?

yeet.md is a free Markdown sharing tool. You paste Markdown into a split-pane editor, click **Publish**, and get a permanent shareable URL like `https://yeet.md/s/abc123` that anyone can read. No account, no signup, no email required.

Each publish creates an **immutable snapshot** — to change content, publish a new one. The original snapshot keeps working at its original URL until you delete it.

## How it works

1. **Paste Markdown** into the editor. Live preview renders as you type with syntax highlighting, KaTeX math, callouts, and embeds.
2. **Click Publish.** Your snapshot uploads and you get a shareable URL plus a delete token saved to your browser.
3. **Share the link.** Anyone with the URL can read the snapshot. Use the delete token later to unpublish.

## Markdown features supported

- **CommonMark and GitHub-flavored Markdown:** tables, task lists, fenced code, footnotes, strikethrough
- **KaTeX math:** inline `$x^2$` and display `$$\sum$$`
- **Mermaid diagrams** via fenced ` ```mermaid ` blocks
- **Syntax highlighting** via highlight.js for JavaScript, TypeScript, Python, Rust, Go, SQL, YAML, JSON, Bash, CSS, HTML, and more
- **Obsidian-flavored:** callouts (`> [!note]`, `> [!tip]`, `> [!warning]`), highlights (`==text==`), wikilinks (`[[Note]]` and `[[Note|Alias]]`), and YAML frontmatter rendered as a property card
- **Discord-flavored:** spoilers (`||text||`), underline (`__text__`), subtext (`-# small`), emoji shortcodes
- **Auto-embeds** for YouTube and X/Twitter URLs in image syntax

## What it costs

Nothing. yeet.md is free to use. Content limits: 3 characters minimum, 500 KB maximum per snapshot. Publishing is rate-limited at 100 publishes per IP per hour for abuse prevention.

## How is yeet.md different from Pastebin, GitHub Gist, or HackMD?

Pastebin and Gist render Markdown but treat it as a code paste — not a styled document. HackMD requires an account for most features. yeet.md renders Markdown as a clean styled document with Obsidian and Discord extensions, requires no account, and produces an immutable shareable URL in one click.

## FAQ

**Do I need an account?**
No. Publishing requires no signup or email. The only thing tying a snapshot to you is a delete token kept in your browser's localStorage.

**Are published snapshots editable?**
No. Snapshots are immutable by design. To change content, publish a new snapshot and (optionally) delete the old one using the delete token saved at publish time.

**How long do snapshots last?**
Indefinitely. There is no automatic expiry. Snapshots persist until you delete them.

**Is there an API?**
Yes. `POST https://yeet.md/api/share` to publish, `DELETE https://yeet.md/api/delete/:id` to unpublish. Full docs at <https://yeet.md/api>.

**Is there a browser extension or Obsidian plugin?**
Yes. Browser extension for Chrome and Firefox publishes from a popup or right-click menu. Obsidian plugin publishes the active note with one command. Downloads on the [about page](https://yeet.md/about).

**Are snapshots private?**
No. Every snapshot URL is public. Anyone with the link can read it. URLs are unguessable enough that they're not casually discoverable, but should not be used for secrets.

## Links

- [About yeet.md](https://yeet.md/about)
- [Markdown cheat sheet](https://yeet.md/cheat-sheet)
- [API documentation](https://yeet.md/api)
- [Privacy policy](https://yeet.md/privacy)
- [Source on GitHub](https://github.com/davidvkimball/yeet.md)
