Pagecord

Pagecord

Install Pagecord from the Obsidian community plugin directory: https://community.obsidian.md/plugins/pagecord

Publish notes from Obsidian to your Pagecord blog.

Write in Obsidian, hit a command, done. Supports images, frontmatter, and drafts.

Features

• Publish notes as blog posts or drafts
• Update existing posts (tracks via frontmatter)
• Upload embedded images automatically
• Publish to multiple configured Pagecord blogs
• Read title, slug, tags, and more from frontmatter

Installation

In Obsidian, go to Settings → Community Plugins → Browse and search for Pagecord.

Setup

1. Enable the API in your Pagecord blog settings
2. Copy your API key
3. In Obsidian, go to Settings → Pagecord
4. Under Pagecord Blog Connections, click the + icon
5. Enter a blog name and API key, then click Save

Use the edit and delete icons beside a connection to update or remove it. Deleting a connection only removes it from Obsidian settings; it does not delete the Pagecord blog.

Commands

Open the command palette (Cmd/Ctrl + P) and run:

• Publish to Blog Name – creates or updates the post as published
• Publish to Blog Name (draft) – creates or updates the post as a draft

Commands are only available when a markdown file is active. One pair of commands is shown for each saved blog connection.

Frontmatter

You can use YAML frontmatter to override post metadata:

---
title: My Post Title
slug: my-post-title
tags: [personal, update]
published_at: 2025-01-15T10:00:00Z
canonical_url: https://example.com/original
hidden: false
locale: en
---

All fields are optional. You do not need frontmatter for the basics: the plugin uses the note filename as the default title, Pagecord generates the slug if you omit one, and the command you run chooses whether the post is published or saved as a draft. Add tags explicitly if you want tags on the post, and use the other fields only when you want to change the defaults.

After publishing, the plugin adds metadata to your frontmatter automatically:

• pagecord_token – links the note to the Pagecord post so future publishes update it instead of creating a duplicate
• pagecord_blog_fingerprint – links the note to the configured Pagecord blog used for publishing. It does not contain your API key
• pagecord_attachments – caches uploaded image hashes so unchanged images aren't re-uploaded
• status – records the last status used by the publish command

These fields are managed by the plugin. Deleting pagecord_token will cause the next publish to create a new post. Existing notes published before multi-blog support still work; the plugin adds pagecord_blog_fingerprint after the next successful update.

Images

For images you want Pagecord to host, drag the image into Obsidian or otherwise add it as a local file in your vault, then embed it in the note. Both Obsidian image syntaxes are supported:

• ![[photo.jpg]] (wiki-style)
• ![](https://raw.githubusercontent.com/lylo/obsidian-pagecord/HEAD/photo.jpg) (markdown-style)

Vault-local images are uploaded to Pagecord and embedded in the post automatically. The plugin sends each file to the Pagecord attachments API, receives an attachable_sgid, and replaces the Markdown image reference with the Action Text attachment tag Pagecord needs.

External Markdown images, such as ![](https://example.com/photo.jpg), are left as normal Markdown image tags. They will reference the external image URL and are not uploaded to Pagecord.

Supported upload formats: JPEG, PNG, GIF, WebP.

Building from Source

git clone https://github.com/lylo/obsidian-pagecord.git
cd obsidian-pagecord
npm install
npm run build

Copy main.js and manifest.json to your vault's .obsidian/plugins/pagecord/ directory.

Local Development

The plugin sends requests to https://api.pagecord.com by default. To point a local test install at another Pagecord API host, add a baseUrl value to the plugin's Obsidian data file.

The data file lives inside your vault:

<vault>/.obsidian/plugins/pagecord/data.json

For a local Pagecord environment, it should look like this:

{
	"baseUrl": "http://api.localhost:3000",
	"blogs": [
		{
			"name": "Local test blog",
			"apiKey": "your-api-key"
		}
	]
}

If Obsidian has already saved your Pagecord settings, keep the existing blogs array and add only the top-level baseUrl field.

License

MIT