- Overview
- Scorecard
- Updates5
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
- 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
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
---
| Field | Usage |
|---|---|
title |
Post title (falls back to filename). Leave the value blank (title: or title: "") to publish without a title |
slug |
URL slug (auto-generated by Pagecord if omitted) |
tags |
Array or comma-separated string |
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. 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 duplicatepagecord_attachments– caches uploaded image hashes so unchanged images aren't re-uploadedstatus– 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.
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)(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 , 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/obsidian-pagecord/ directory.