Olly

Pagecord CLI

I’ve published a small Pagecord command line app (CLI) for people who want to write on their local machine in Markdown (or HTML) and publish those files to Pagecord. If you use Obsidian, you should use the dedicated plugin, but if you use something else then the CLI app might be able to help.

The app is written in Ruby (❤️), and you install it from RubyGems:

gem install pagecord-cli

Once installed, you can log in using the login command and passing your blog subdomain:

pagecord login blog-subdomain

This will ask for your API key, which will be used to authenticate you.

Once you're logged in, you can save posts to your blog as draft or published using the draft and publish commands:

# subdomain is only required if you're logged into two or more blogs
pagecord draft post.md [subdomain]
pagecord publish post.md [subdomain]

If you want to move a published post back to draft, use the draft command.

Images

Images are supported as with the Obsidian plugin. Just reference the local file in your Markdown and it will be uploaded to Pagecord.

After syncing a file (draft or published), you'll notice some frontmatter entries appear such as pagecord_token, pagecord_blog_fingerprint, and pagecord_attachments – these are required by the app to identify the blog post and attachments in Pagecord, so please don't edit them.

Options

Frontmatter in your Markdown file is supported as per the Obsidian plugin, but if you prefer you can use CLI options to configure the post.

Note: The CLI app and Obsidian plugin use the same Pagecord frontmatter, so you can move between them. A post first published from the CLI can later be edited and synced from Obsidian, and a note first published from Obsidian can later be updated from the CLI.

Setting the title (or no title)

# by default the title is set to be the same as the file name
--title "Custom title"
--title ""

Changing the post slug

--slug my-new-post-slug

Changing the publication time

--published-at 2026-06-11

Adding tags

--tags ruby,cli

Add canonical URL

--canonical-url https://example.com/original

Making the post hidden

--hidden

Changing the post locale

--locale en

The CLI app covers the main workflows. If you want to delete a post, you'll need to head into the Pagecord UI.

Hopefully this app opens up options for people who want to write locally in other editors like iA Writer, Vim or Emacs, or do some automation, but who don't want to fiddle with the Pagecord API itself.

Composing your blog posts locally on your own device is a great way to use Pagecord. You can export your data from Pagecord at any time of course, but writing locally means you own all your content from the outset. Your posts are just files that you can back up, store on Dropbox, whatever you like!

This is how I write most blog posts now, and I've published this one using the CLI app itself.

pagecord