The Send to Ghost plugin enables users to publish or draft notes directly from Obsidian to the Ghost blogging platform. It supports authentication via Staff Access Tokens or Admin API Keys, allowing secure integration with Ghost. The plugin uses front matter to customize post settings, such as titles, tags, featured images, and publication status. By streamlining the process of exporting notes to Ghost, this plugin is ideal for bloggers and content creators who use Obsidian for drafting their posts.
This release changes some of the settings fields to be more inclusive of Staff Access Tokens, which are now the preferred way of authenticating with Ghost (over an Admin API Key).
Each staff member on your site has a Staff Access Token which allows them to authenticate with Ghost as themselves, with the same permissions as they have. They are preferred over an Admin API Key because of their more limited access to the API, and the ability for them to be used by any staff member regardless of their permissions. They are also available to Ghost Pro users on the Starter Plan, who don't have access to Custom Integrations and Admin API Keys. Admin API Keys will continue to be supported, since they use the exact same authentication system.
A maintained fork of Jay Nguyen's obsidian-ghost-publish. It allows you to send Obsidian notes to the Ghost blogging software, either as published or draft posts.
Send to Ghost can use either a Staff Access Token or an Admin API Key. Each staff member has their own Staff Access Token which gives Send to Ghost permission to do all the things that they can do, while an Admin API Key must be created manually and gives all permissions. Because Obsidian plugins can't store sensitive information securely, you should use a Staff Access Token, since its access is more limited. You could also consider creating a seperate staff user with barebones permissions for uploading posts if you are concerned about the security of your site.
Note that the Staff Access Tokens of users who have Administrator or Owner permissions have the same access as Admin API Keys. They are still preferred, since their access to your site is tied to the access of the staff member who they belong to. They are also usable with Starter sites on Ghost Pro.
To get your Staff Access Token, go to the admin dashboard and click the avatar in the bottom-right corner, then click "Your Profile". Scroll down to find the token, hover over it and click the "copy" button to copy it to the clipboard.
After installing the plugin in Obsidian, go to its settings and fill in the fields. Put the URL of your Ghost site in the "Site URL" field (or the ghost.io
URL if you're using Ghost Pro), and your Staff Access Token/Admin API Key in the "Access Token" field. You can now click the ghost icon in the ribbon menu on the left or use the "Send to Ghost" command in the command palette to send the currently open note to Ghost.
Send to Ghost uses front matter to set Ghost-specific settings such as the title, tags, and the featured image. You can add front matter by enclosing it in ---
at the beginning of a note.
The following options are supported:
---
title: String (default: filename)
tags: (default: none)
- tag1
- tag2
featured: Boolean (default: false)
published: Boolean (default: false)
excerpt: String (default: blank)
feature_image: String (default: blank)
---
This plugin uses PNPM for dependency management.
pnpm i
to install the necessary dependenciespnpm dev
to automaticlly recompile as the project files change.pnpm build
main.js
and manifest.json
to VaultFolder/.obsidian/plugins/send-to-ghost/
where Vaultfolder
is the location of your Obsidian vault.If you find a bug, please submit an issue. Otherwise, please contact me via my website.