Publish Markdown from the command line. Three commands to go from file to shareable link.
$ jotbird publish README.md
Published: https://share.jotbird.com/bright-calm-meadow
Every published page gets a responsive URL — no ads, no tracking, no clutter, just your content. Unlike gists, pastebins, and wikis, JotBird links are readable, unlisted, and designed to be shared — not browsed. Noindex by default.
Requires Node.js 18+.
npm install -g jotbird# 1. Log in (one-time setup)
jotbird login
# 2. Publish a file
jotbird publish notes.md
# 3. Update it — same URL, fresh content
jotbird publish notes.md| Command | Description |
|---|---|
jotbird login |
Authenticate with your JotBird account |
jotbird publish <file> |
Publish or update a Markdown file |
jotbird publish --slug <slug> <file> |
Update a specific document by slug |
jotbird publish |
Read Markdown from stdin |
jotbird list |
List your published documents (also visible in the web app as read-only) |
jotbird unpublish <file|slug> |
Take down the public URL (keeps document in account) |
jotbird remove <file|slug> |
Permanently delete a document |
jotbird help |
Show help |
The CLI tracks file-to-slug mappings in a .jotbird file in your working directory. When you publish the same file again, it updates the existing document at the same URL.
$ jotbird publish README.md
Published: https://share.jotbird.com/bright-calm-meadow
$ jotbird publish README.md
Updated: https://share.jotbird.com/bright-calm-meadowPipe from stdin for scripts and CI:
cat notes.md | jotbird publish
echo "# Hello" | jotbird publishWhen publishing from stdin, no file mapping is created — each publish creates a new document.
To update a specific document by slug — regardless of file tracking — use the --slug flag:
jotbird publish --slug bright-calm-meadow notes.md
echo "# Updated" | jotbird publish --slug bright-calm-meadowRun jotbird login to open your browser and authenticate. The CLI will automatically receive your API key once you sign in — no copy-pasting required. If the browser doesn't open, the CLI displays a URL to visit manually and falls back to a paste prompt.
The key is stored locally at ~/.config/jotbird/credentials with 0600 permissions.
Image uploads are not supported. Markdown image references (e.g. ) will render only if they point to externally-hosted images.
| Free | Pro | |
|---|---|---|
| Published links | 90 days expiration | Permanent |
| Active documents | 10 | Unlimited |
| Rate limit | 10 publishes/hour | 100 publishes/hour |
Upgrade at jotbird.com/pro.
MIT