notion-sync

Synchronize Obsidian notes with Notion bidirectionally using the obsidian-notion CLI.

Updated Mar 13, 2026
One-click install
npx skills add https://github.com/knowledgexhunta/devops-toolkit --skill notion-sync-knowledgexhunta
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: notion-sync
Source: https://github.com/knowledgexhunta/devops-toolkit/tree/main/plugins/devops-toolkit/skills/notion-sync
Command: npx skills add https://github.com/knowledgexhunta/devops-toolkit --skill notion-sync-knowledgexhunta

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Bidirectional synchronization between your Obsidian vault and Notion, enabling notes to stay in sync across both platforms while respecting privacy constraints.

Core Features & Use Cases

  • Bidirectional sync between Obsidian and Notion using the obsidian-notion CLI.
  • Enforce privacy: exclude work notes and respect the vault's safety policy.
  • Safe operations: supports push, pull, status, and conflicts resolution with dry-run and path-scoped commands.
  • What gets synced: wiki-links, frontmatter YAML, callouts, highlights, code blocks, and headings; supports basic mappings and troubleshooting.

Quick Start

Run a safe bidirectional sync between your Obsidian vault and Notion for personal notes, excluding work content.

Frequently Asked Questions about notion-sync

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I sync Obsidian notes with Notion bidirectionally?

You can sync Obsidian notes with Notion bidirectionally by using an automated CLI that maintains parity across platforms through push, pull, and conflict resolution operations. This ensures personal notes stay updated across both tools while respecting privacy constraints.

What is bidirectional sync between Obsidian and Notion?

Bidirectional sync is a process that maintains note parity between Obsidian and Notion by pushing and pulling content updates across both platforms. It automatically handles wiki-links, frontmatter YAML, callouts, highlights, code blocks, and headings to keep workflows consistent.

Can I exclude specific work notes from an Obsidian to Notion sync?

Yes, you can exclude specific work notes from an Obsidian to Notion sync by applying path-based filtering and a work exclusion policy. This enforces privacy constraints by scoping synchronization operations to only your personal note workflows.

How do I resolve sync conflicts between Obsidian and Notion safely?

You can resolve sync conflicts safely by running pre-sync checks and dry-run previews before executing bidirectional synchronization. This allows you to review status checks and identify conflicts between your Obsidian vault and Notion without risking unintended data overwrites.

Does bidirectional Obsidian-Notion sync support frontmatter YAML and wiki-links?

Yes, bidirectional Obsidian-Notion sync supports frontmatter YAML and wiki-links, along with callouts, highlights, code blocks, and headings. Configurable mappings ensure these structural elements are correctly translated between platforms during synchronization operations.

What are the limitations of syncing notes between Obsidian and Notion?

Limitations of syncing notes between Obsidian and Notion include strict privacy constraints that enforce the exclusion of work notes. Synchronization is scoped to personal workflows, and users must rely on dry-run previews to navigate potential conflicts safely before execution.