Send to Ghost
by Southpaw1496
Score: 28/100
favorite
share
Description
Category: 3rd Party Integrations

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.

Stats
35
stars
3,571
downloads
9
forks
550
days
300
days
436
days
0
total PRs
0
open PRs
0
closed PRs
0
merged PRs
8
total issues
4
open issues
4
closed issues
6
commits
Latest Version
a year ago
Changelog

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.

README file from

Send to Ghost

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.

Usage

Authentication

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.

Finding your Access Token

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.

Using the plugin

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.

Front Matter format

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)
---

Development

This plugin uses PNPM for dependency management.

  • Clone the repository.
  • Run pnpm i to install the necessary dependencies
  • Run pnpm dev to automaticlly recompile as the project files change.

Manual installation

  • Run pnpm build
  • Copy main.js and manifest.json to VaultFolder/.obsidian/plugins/send-to-ghost/ where Vaultfolder is the location of your Obsidian vault.

Issues & Support

If you find a bug, please submit an issue. Otherwise, please contact me via my website.