Ghost-Writer Sync#

Automatically pulls your published blog posts (Substack / Ghost) into your local Obsidian or Logseq vault for AI-assisted repurposing.

How It Works#

text

Blog Source  →  Fetch Posts  →  HTML → Markdown  →  Write to Vault
(Substack RSS / Ghost API)       (stdlib)         (frontmatter + body)

1. Fetch — Pulls published posts from each configured source
2. Convert — Transforms HTML content to clean Markdown using a stdlib-only converter
3. Write — Saves each post as a Markdown file with rich frontmatter in your vault

Supported Sources#

SourceAuthNotesSubstackNone (public RSS)Reads the /feed endpointGhostContent API key ( id:secret)Uses Admin API JWT auth

Output Formats#

FormatFrontmatterFilenameObsidianYAML block ( --- delimited){slug}.mdLogseqProperty list ( key:: value){date} {slug}.md

Frontmatter Fields#

Every synced post includes:

FieldDescriptiontitlePost titlesource``substack or ghost``urlOriginal post URLpublishedPublication datesyncedTimestamp of last syncpost_idStable hash-based ID for deduptags(Ghost only) Tag namesexcerpt(Ghost only) Post excerptfeature_image(Ghost only) Hero image URL

Usage#

Add a source#

bash

# Substack — just the URL
python3 sync.py add-substack --url https://example.substack.com

# Ghost — URL + API key
python3 sync.py add-ghost --url https://myblog.ghost.io --api-key abc123:def456...

Run a sync#

bash

python3 sync.py sync --vault /path/to/obsidian-vault

Check config#

bash

python3 sync.py list
python3 sync.py config

Repurposing Workflow#

Once posts are in your vault, use your AI assistant to:

• Rewrite posts as Twitter/X threads
• Generate LinkedIn summaries
• Create newsletter compilations
• Extract key quotes and talking points
• Draft follow-up posts based on themes

Posts land as standard Markdown files, so they work with any Obsidian plugin, Logseq graph, or AI tool that reads .md files.