# yeet.md

> Paste Markdown, get a public shareable link. Free, no account required, optional GitHub sign-in to manage what you publish.

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

Published anonymously, a snapshot cannot be changed afterwards: to change content, publish a new one. If you sign in with GitHub (optional), you can edit your own snapshots in place at the same URL, and the page shows the date it was edited.

## 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||`), subtext (`-# small`), mentions, timestamps, emoji shortcodes. `__text__` renders as bold, following Markdown everywhere else, rather than Discord's underline
- **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 a 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?**
If you published while signed in with GitHub, yes: edit it from your dashboard and the URL stays the same, with the page showing the date it was edited. Anonymous snapshots cannot be edited; publish a new one and delete the old one using its delete token.

**Do I have to sign in?**
No. Anonymous publishing works exactly as before. Signing in with GitHub is optional and adds a dashboard of what you have published plus the ability to edit or delete it.

**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)