@im-nobsidian/core

Core sync engine for Im-Nobsidian — the only true bidirectional sync between Obsidian and Notion.

The programmable engine behind the nobsi CLI and the Im-Nobsidian Obsidian plugin — importable directly for custom integrations. Markdown ↔ Notion conversion (25+ block types, round-trip markers for lossless preservation), frontmatter ↔ property mapping (21 read / 15 write types), 3-way conflict resolution, and incremental sync orchestration.

Install

npm install @im-nobsidian/core

ESM only, Node.js 20+.

Modules

• converter/ — Markdown ↔ Notion conversion. createDefaultPipeline(); preserve markers keep Notion-only blocks, colors and underlines lossless on round-trip.
• notion/ — NotionClient (official SDK, 3 req/s rate limit), NotionBlockBuilder, PropertyMapper.
• sync/ — SyncOrchestrator (pull / push / sync), DatabaseSyncer.
• state/ — StateDB sync-state database (IStateDB interface — better-sqlite3 in the CLI, sql.js in the plugin).
• conflict/ — threeWayMerge, ConflictResolver.
• structure/ — TreeMapper (folder tree ↔ page hierarchy).
• watcher/ — FileWatcher, WatchSyncService.
• audit/ — classifyBodyFidelity, summarizeFidelity (round-trip fidelity measurement).

Usage

import { SyncOrchestrator, ConfigManager } from "@im-nobsidian/core";

The engine is configuration-driven (Notion token, root page, vault path). For an end-to-end reference, see the nobsi CLI — a thin wrapper over this package.

Documentation

Repo · Architecture · Changelog

License

MIT © hanseungheon