Skip to content

roomi-fields/obsidian-content-publisher

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

52 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Obsidian Content Publisher

Publish your Obsidian notes to multiple platforms: Substack, WordPress, and more

CI codecov TypeScript Obsidian License: MIT Node.js

InstallationPlatformsUsageRoadmap


Supported Platforms

Platform Status Features
Substack Draft/publish, images, audience targeting, sections
WordPress Multi-server, categories, tags, Rank Math SEO
LinkedIn 🚧 Coming soon

See PLATFORMS.md for detailed setup and frontmatter documentation.


Features

Substack

  • One-Click Login — Automatic Substack authentication (desktop only)
  • Draft & Publish — Save as draft or publish immediately
  • Multi-Publication — Manage multiple Substack publications
  • Audience Control — Target everyone, paid-only, free-only, or founding members
  • Tags & Sections — Organize posts with tags and publication sections

WordPress

  • Multi-Server — Configure multiple WordPress sites (production, staging, etc.)
  • Server Selector — Choose which server to publish to
  • Categories & Tags — Auto-fetch categories, create tags on the fly
  • SEO Integration — Rank Math meta fields support
  • Wikilinks — Automatic conversion to WordPress internal links

General

  • Markdown Conversion — Full conversion to platform formats
  • Image Upload — Local images auto-uploaded to platform CDN
  • Frontmatter Support — Configure per-post settings via YAML
  • Cross-Platform — Publish to WordPress first, then Substack with link

Installation

From Community Plugins (Coming Soon)

  1. Open Settings → Community plugins
  2. Search for "Content Publisher"
  3. Install and enable

Manual Installation

  1. Download main.js, manifest.json, styles.css from latest release
  2. Create folder: .obsidian/plugins/content-publisher/
  3. Copy files into the folder
  4. Restart Obsidian → Enable plugin

Quick Start

Substack

  1. Go to Settings → Content Publisher → Authentication
  2. Click "Login" to authenticate with Substack
  3. Click "Refresh" to fetch your publications

WordPress

  1. Go to Settings → Content Publisher → WordPress
  2. Enable WordPress publishing
  3. Add a server with your WordPress URL and Application Password
  4. Click "Fetch from WP" to load categories

Usage

  1. Open any Markdown note
  2. Add frontmatter (optional) for platform-specific settings
  3. Click the ribbon icon or use command palette
  4. Select platform and options
  5. Publish or save as draft

See PLATFORMS.md for frontmatter examples and platform-specific options.


Privacy & Security

  • Credentials stored locally in your vault
  • No telemetry or data collection
  • WordPress uses Application Passwords (not your login)
  • Open source — audit the code yourself

Troubleshooting

Error Solution
"Session expired" (Substack) Re-login via Settings → Login
"Publication not found" Check subdomain spelling
"401 Unauthorized" (WordPress) Check Application Password
Plugin not loading Enable in Community plugins, restart Obsidian

Roadmap

See ROADMAP.md for planned features.

Coming soon:

  • LinkedIn publishing
  • Cover image support
  • Scheduled publishing

Credits

Built upon these open-source projects:

See ATTRIBUTIONS.md for details.


License

MIT License — See LICENSE for details.


Contributing

Found a bug? Have an idea? Open an issue or submit a PR!

See CONTRIBUTING.md for guidelines.


Disclaimer: This plugin uses unofficial APIs. Not affiliated with Substack or WordPress.

Star on GitHub if this helps you!

About

Publish your Obsidian notes directly to Substack

Resources

License

Contributing

Security policy

Stars

Watchers

Forks

Packages

No packages published

Contributors 4

  •  
  •  
  •  
  •