README file from
GithubPagecord
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
- Read title, slug, tags, and more from frontmatter
Installation
In Obsidian, go to Settings → Community Plugins → Browse and search for Pagecord.
Setup
- Enable the API in your Pagecord blog settings
- Copy your API key
- In Obsidian, go to Settings → Pagecord and paste your API key
Commands
Open the command palette (Cmd/Ctrl + P) and run:
- Publish to Pagecord — creates or updates the post as published
- Publish as draft to Pagecord — creates or updates the post as a draft
Commands are only available when a markdown file is active.
Frontmatter
Use YAML frontmatter to set post metadata:
---
title: My Post Title
slug: my-post-title
tags: [personal, update]
status: published
published_at: 2025-01-15T10:00:00Z
canonical_url: https://example.com/original
hidden: false
locale: en
---
| Field | Usage |
|---|---|
title |
Post title (falls back to filename). Set to false to create a post without a title |
slug |
URL slug (auto-generated by Pagecord if omitted) |
tags |
Array or comma-separated string |
status |
published or draft (updated automatically when you publish) |
published_at |
ISO 8601 timestamp |
canonical_url |
Canonical URL for the post |
hidden |
true to hide from the feed |
locale |
Post language code |
All fields are optional.
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 duplicatepagecord_attachments— caches uploaded image hashes so unchanged images aren't re-uploaded
These fields are managed by the plugin. Deleting pagecord_token will cause the next publish to create a new post.
Images
Both Obsidian image syntaxes are supported:
![[photo.jpg]](wiki-style)(markdown-style)
Images are uploaded to Pagecord and embedded in the post automatically. Supported 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/obsidian-pagecord/ directory.