publish-sync

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