Obsidian Publish & Sync
Manage Obsidian Publish and Obsidian Sync services using the official CLI.
Prerequisites
-
Obsidian desktop v1.12.4+ with CLI enabled
-
Obsidian must be running
-
Active Obsidian Publish and/or Sync subscription for respective commands
When to Use
Use this skill automatically when:
-
User wants to list, add, or remove notes from Obsidian Publish
-
User needs to check Obsidian Sync status
-
User asks about publishing workflow or sync state
Obsidian Publish
List Published Notes
All currently published notes
obsidian publish:list
JSON output
obsidian publish:list format=json
Add to Publish
Publish a note
obsidian publish:add file="Public Note"
Publish by path
obsidian publish:add path="blog/post.md"
Remove from Publish
Unpublish a note
obsidian publish:remove file="Draft Post"
Obsidian Sync
Check Status
Current sync state
obsidian sync:status
Publishing Workflow
Batch Publish
Find all notes tagged for publish, then add them
obsidian search query="[tag:publish]" format=json
Then publish each result
obsidian publish:add file="Note Name"
Publish Audit
Compare published notes with tagged notes
obsidian publish:list format=json obsidian tag tagname=publish
Agentic Optimizations
Context Command
List published (structured) obsidian publish:list format=json
Publish a note obsidian publish:add file="X"
Unpublish a note obsidian publish:remove file="X"
Sync status obsidian sync:status
Related Skills
-
vault-files — Create and manage notes before publishing
-
properties — Set publish-related properties on notes
-
search-discovery — Find notes tagged for publishing