open source MIT license node.js ≥ 18

Publish posts
from your terminal

Write a markdown file, run one command, and it's live on GitHub. No config, no init, no backend.

zero deps · plain node · json posts

$ publish ~/notes/my-post.md
Saved posts/my-post.json
✓ Pushed to GitHub

Reference

One tool. Three commands.

Every command does one thing and prints exactly what happened. No hidden state.

cli reference

command	what it does	output
$ publish my-post.md	Convert markdown to JSON, commit, push to GitHub	posts/my-post.json
$ publish	Run without a path — shows usage and available formats	usage message
$ npm install -g	Install the CLI everywhere. Zero config after that	global binary

How it works

Create any .md or .txt file. Plain text, no fluff.

Run publish. Saves JSON, commits, and pushes to GitHub.

Your website loads JSON from the GitHub raw URL. No backend needed.

Point blog-cli at any markdown file. It saves, commits, and pushes — all in one command.

post path

own taste, own tools

Clone, install, publish. No config, no init, no hassle.