Back to skills
extension
Category: Development & EngineeringNo API key required

publish-sync

Obsidian Publish and Sync management via the official CLI. Covers listing published notes, adding/removing notes from Publish, and checking Obsidian Sync status. Use when user mentions Obsidian Publish, publishing notes, Obsidian Sync, or sync status.

personAuthor: jakexiaohubgithub

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