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