Publish Markdown.
Get a link. Done.
Open-source, self-hosted Markdown publishing. One CLI command turns Markdown into a shareable web page — free forever on Cloudflare.
No account required — try it with openbird publish --temp
$ openbird publish notes.md
✨ Published → https://openbird.jhao.space/quiet-blue-lakeWhy OpenBird?
Everything you need to publish Markdown from the terminal.
CLI-first publishing
One command publishes Markdown to a shareable URL. Update or delete anytime, right from the terminal.
Self-hosted & free
Runs entirely on Cloudflare's free tier. Your content, your infrastructure, no subscriptions.
Smart image handling
Local images auto-upload to R2 and rewrite to URLs. No manual hosting, no broken links.
Memorable URLs
Random slugs out of the box, or username/slug namespace for permanent links.
How it works
Three steps from a Markdown file to a published link.
Install the CLI
Clone the repo and link the CLI. Zero npm dependencies — just Node.js 18+.
Publish in one command
openbird publish notes.md renders your Markdown and hands back a shareable link.
Share & manage
Open the URL in any browser. Update or remove with a single command, anytime.
See it in action
From zero to a published page in under a minute.
# 1. Install the CLI (zero dependencies)
git clone https://github.com/PPsteven/openbird.git
cd openbird/cli && npm link
# 2. Login (or skip with --temp)
openbird login
# 3. Publish
echo "# Hello OpenBird" > hello.md
openbird publish hello.md
✨ Published → https://openbird.jhao.space/quiet-blue-lake
# Anonymous temp publish, expires in 1 hour
openbird publish --temp hello.md
⚡ Published (temp, 1h) → https://openbird.jhao.space/warm-clear-seed
# Namespace permanent URL
openbird publish --namespace my-post hello.md
✨ Published → https://openbird.jhao.space/ppsteven/my-postWhat will you publish with OpenBird?
From quick notes to detailed docs — if you can write it, you can share it.
Publish from anywhere
Publish from the terminal, your CI pipeline, or your own code. OpenBird has tools for every workflow.
Terminal
Publish Markdown files straight from the terminal. Pipe from scripts, CI, or any tool that outputs text.
Learn more → RESTAPI
A simple REST API for publishing, listing, and deleting documents. Build your own integrations in any language.
Learn more → CI/CDPipelines
Publish release notes, changelogs, or build artifacts from GitHub Actions. Set OPENBIRD_API_KEY and go.
Deploy your own
One wrangler deploy spins up your own instance on Cloudflare's free tier. Full control, zero cost.
Free and open source
Self-host on Cloudflare's free tier. MIT licensed. No subscriptions, no lock-in. Your content, your infrastructure.
Star on GitHubNo tracking. No ads. Ever.
- Your Markdown stays on your device until you publish.
- Published pages are unlisted — no ads, no tracking pixels.
- Temporary links expire in 1 hour. Namespace links are yours to keep.