Obsidian Stats logoObsidian Stats

Ghost Publish

by Sébastien Dubois
5
4
3
2
1
Score: 36/100
Install Code

Description

Publish your vault notes to a Ghost blog with configurable presets for tags, newsletters, and frontmatter conventions.

Reviews

No reviews yet.

Stats

2
stars
448
downloads
1
forks
94
days
6
days
22
days
6
total PRs
6
open PRs
0
closed PRs
0
merged PRs
1
total issues
0
open issues
1
closed issues
55
commits

Latest Version

1.0.0
22 days ago

Changelog

1.0.0 (2026-08-29)

⚠ BREAKING CHANGES

  • plugin: minAppVersion is now 1.13.0 (was 1.8.7). The settings pane uses the declarative settings API introduced in Obsidian 1.13.
  • getSettingDefinitions() replaces the imperative render path: 8 groups (Ghost, Public mirror, Triage, Content processing, Frontmatter properties, Tags & newsletters cache, Presets, Advanced, Support) with every declared name/desc indexed by the settings search.
  • The Ghost Admin API key stays a render: row with a password input — the declarative text control cannot render one, and the key must never appear in clear text.
  • excludedFolders, stripSections and knownUrls become textarea controls that serialize in getControlValue and parse in setControlValue (malformed known-URL lines are dropped, exactly as before). URL fields normalize (trim + trailing slashes) in setControlValue.
  • The 10 frontmatter property names are text controls behind frontmatter. keys, validated against the known field list.
  • The preset list keeps its custom row UI (enable toggle, move, edit-in-modal, confirmed delete) inside one render: row — the native list's delete affordance would bypass the confirmation modal. Structural preset edits are serialized behind a latch, mutate the committed draft inside the mutator, and refresh the view + pane only AFTER the write lands; a failed write shows a notice and keeps the pane instead of discarding state.
  • The cache section's refresh persists through the serialized write path, so a settings edit can no longer clobber a concurrent cache refresh (both used to produce from the same stale base).
  • updateSettings becomes the serialized persist-then-commit write path from the template; saveSettings is documented as load-time-only.
  • Support block and preset editor rows get block layout via an unlayered .setting-item.gp-settings-embed rule.
  • Tests: settings-guard.spec.ts + settings-write.spec.ts (15 behavioral tests: queue, rollback, normalization, textarea round-trips, dot-key validation, preset latch; mutation-checked against an optimistic commit, an unserialized chain, and a removed latch — each breaks at least one test).
  • Docs: README and docs/configuration.md state the 1.13 requirement; AGENTS.md gains the declarative-settings section with the repo-specific shapes (password row, preset editor, textarea serialization, plugin-owned caches).

Features

  • plugin: declare the settings tab (Obsidian 1.13 declarative settings) (305049e)
  • plugin: show what's new in a tab instead of a modal dialog (55d9e86)
  • plugin: surface support CTAs everywhere users can see them (1e92133)

Bug Fixes

  • build: align with the catalog reviewer's archive, ruleset and audit (2809253)
  • plugin: harden the settings write paths after adversarial review (3024032)
  • release: unattended-flag fixes from the template (0cead60)

Enjoying this plugin?

See all version on GitHub

README file from

Github

Ghost Publish

Publish your vault notes to a Ghost blog with configurable presets. Each preset captures a publication target — tags, newsletter, canonical-URL strategy, status — and shows up as a tab in the side panel.

Features

  • Presets — define one or more publication profiles (Blog post, News, Microblog, …). Each preset has its own tags, optional newsletter slug, and publication status.
  • Side panel — one tab per preset, with sub-tabs for Triage (review candidate notes), Queue (notes flagged for sync), and Recently published.
  • Search — a search box at the top of the panel fuzzy-filters the active sub-tab's list by note title and path (typo-tolerant, e.g. obsk → Obsidian Starter Kit). The query carries over when you switch sub-tabs.
  • Triage — pick notes to publish from a time-range filter, with one-click publish, publish + email and ignore actions.
  • Idempotent sync — each note's body is hashed (SHA-256); unchanged notes skip the round-trip. Ghost post ids are recorded in frontmatter for in-place updates.
  • Auto-fetched tag and newsletter lists — connect once, click Refresh tags & newsletters, and the preset editor offers autocomplete + dropdowns from the cached data.
  • Image upload — every ![[image]] embed is uploaded to Ghost and rewritten to a Ghost image card.
  • Wikilink resolution — known-URL map, optional public-mirror lookup, bold-text fallback.
  • Embed upgrades — YouTube links become Ghost oembed cards; LINK: blocks become bookmark cards.
  • Footnotes — Markdown footnotes (text[^1], [^1]: …, and inline ^[…]) are rendered to proper footnote anchors and a footnotes section on the published post.
  • Configurable frontmatter keys — bring your own property names so existing vaults can keep their conventions.
  • Listing notes (optional) — per preset, maintain a markdown index of every post currently published.
  • What's new after updates. After a plugin update, a one-time dialog shows the release notes you just received (including skipped versions) with ways to support development. Never shown on fresh installs or regular restarts.

Install

Requires Obsidian 1.13.0 or later. The settings pane uses the declarative settings API introduced in 1.13. On an older version the plugin will not load, and the community catalog will not offer it to you — but a manual or BRAT install can still put an incompatible build in your vault, so check Settings → About first.

isDesktopOnly: true — the plugin needs network access to Ghost and reads GHOST_ADMIN_KEY as an optional env fallback.

Manual install:

  1. Build the plugin (bun install, then bun run build).
  2. Copy dist/main.js, dist/manifest.json, dist/styles.css to <Vault>/.obsidian/plugins/ghost-publish/.
  3. Reload, then enable Ghost Publish in Settings → Community plugins.

Quick start

  1. Open Settings → Ghost Publish: fill in Ghost URL and the Admin API key (id:secret from Ghost Admin → Settings → Integrations).
  2. Click Refresh tags & newsletters to populate the autocomplete cache.
  3. Add a preset (e.g. "Blog post"): pick tags, optionally a newsletter, status, canonical URL strategy.
  4. Open the panel (the send ribbon icon).
  5. On the preset tab → Triage sub-tab, pick notes to queue. Switch to Queue and click Sync to Ghost.

Privacy & network

This plugin is desktop-only and makes network requests only to the Ghost site you configure. It does not collect telemetry, does not call any third-party analytics service, and never reads files outside your vault.

External services used:

  • Ghost Admin API at your configured Ghost URL — for creating / updating posts, fetching tags & newsletters, uploading embedded images, and triggering optional newsletter dispatches. Authentication uses an Admin API key you provide (either pasted into settings or read from the GHOST_ADMIN_KEY environment variable).
  • Public mirror URL (optional, per preset) — when a preset enables canonical_url, the plugin performs a HEAD/GET probe against the canonical URL to verify the public version is reachable before publishing. No vault content is sent in this probe.

The plugin never executes remote code and updates only through normal Obsidian releases.

Documentation

License

MIT — see LICENSE.

My other Obsidian plugins

Plugin What it does
Agentic Resource Discovery Server Local-first Agentic Resource Discovery publisher and registry that serves your AI skills and tools to agents over a local HTTP and MCP server
Book Exporter Export books (one manifest note + linked chapter notes) to EPUB and PDF via Pandoc
Bookshelf Base Display your notes as a visual bookshelf via a custom Bases view
Dataview Serializer Serialize Dataview queries to Markdown, and keep the Markdown representation up to date
Expander Replace variables across your vault using HTML comment markers. Supports static values and dynamic functions
Graph Explorer Base View A custom Bases view that renders notes as an interactive force-directed graph with explored/unexplored tracking
Hidden Folders Access Index hidden root-level folders (e.g. .claude) so they appear in the file tree, metadata cache, and Bases
Journal Bases Custom Base views for journaling and periodic reviews
Kanban Action Planner Render your notes as configurable Kanban boards and calendars inside Bases, with statuses, ordering, relationships, and scheduling
Life Tracker Capture and visualize the data that matters in your life
Note Village A 2D pixel art village where your notes become villagers you can explore and chat with using AI
Obsidian Starter Kit Adds strong typing support and powerful automation support for notes
Remarkable Synchronizer Connect to the reMarkable cloud, list, download, and sync notebook pages as images
Replicate Use AI models with ease via the Replicate.com integration
REST and MCP server Exposes CLI commands as RESTful API endpoints and an MCP server for AI tool integration
Time Machine Browse, compare, and restore previous versions of your notes using built-in file-recovery snapshots
Transcriber Transcribe images to markdown using Ollama vision models
Typefully Publish social media posts with ease using the Typefully integration
Update Time Automatically update front matter to include creation and last update times

Everything I build is documented in my newsletter and on my YouTube channel.

News & support

To stay up to date about this plugin, Obsidian in general, Personal Knowledge Management and note-taking:

If this plugin is useful to you, here are the best ways to support my work ❤️:

Found a bug or have an idea? Open an issue.

Sponsors