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, PDFs, frontmatter, and drafts.

Features

• Publish notes as blog posts or drafts
• Update existing posts (tracks via frontmatter)
• Upload embedded images and PDFs 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

Click a connection to update it, or use the delete control beside it to 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 – records each uploaded file against its vault path, so unchanged files aren't uploaded again
• 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 and PDFs

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

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

Vault-local files 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 reference with the Action Text attachment tag Pagecord needs. PDFs are published as attachments showing a preview of the first page, a download link, and the file size.

Obsidian's display modifiers are ignored, so ![[report.pdf#page=2]] and ![[photo.png|300]] upload the whole file and are rendered by Pagecord at its own size.

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, PDF.

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 connection at another Pagecord API host, add a baseUrl value to it in the plugin's Obsidian data file.

The data file lives inside your vault:

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

baseUrl is set per connection, so a local blog can sit alongside your real ones. Each connection gets its own command in the palette, which is how you choose where a note goes:

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

A top-level baseUrl still works and applies to every connection that does not set its own. Obsidian reads this file when the plugin loads, so reload the plugin or restart Obsidian after editing it by hand.

License

MIT