txt/sync/adaptors

APPLE NOTES · GOOGLE DOCS · NOTION · OBSIDIAN

Your notes, across your apps.

Choose what comes into txt. Keep the source, compare edits, and decide what goes back.

Connections run on your computer through txt. Keep the worker running for automatic imports.

Obsidian

Selected Markdown notes can import, watch and write back after review through the CLI. Stable mappings follow vault renames.

Connect a vault or subfolder and an existing txt folder. Embedded attachment bytes, Canvas and Bases remain in Obsidian.

No additional credentials. Select a local Markdown vault or subfolder.

What should carry over

  • Markdown text
  • YAML frontmatter and wikilinks
  • Stable mapping across detected renames

Needs a compatibility check

  • Plugin-only syntax
  • Canvas and Bases files
  • Case-sensitive paths
  • Concurrent Obsidian or cloud sync

Source documents and attachments stay in their original app. The list above describes what the txt copy preserves.

Provider documentation ↗

Try change review

Local example · nothing is saved or sent

Edit either copy to see how txt would handle it.

import updateThe app changed and the txt copy is unchanged.

Sync functions, in plain English

catalog

List appsShow the four adapters, supported content and missing setup.

Available here
preview

Preview changesCompare supplied app and txt snapshots without writing anything.

Available here
connect

Connect an appBind an authorized provider account and select its source plus an existing txt destination.

On your computer
scan

Read changesRead the selected sources and compare them with the last confirmed snapshots.

On your computer
apply

Apply reviewed changesSave allowed changes with revision checks and a durable receipt.

On your computer
watch

Keep up to datePoll the selected source while the local worker is running; restart using saved baselines.

On your computer
resolve

Resolve a conflictResolve reviewed copies by revision: keep source, keep both, or write txt back to an Obsidian vault.

On your computer
status

Check deliveryShow each connection's last confirmed revision, queued work and failures.

On your computer
pause

Pause a connectionStop processing while retaining mappings and confirmed snapshots.

On your computer
resume

Resume a connectionResume a paused connection using its saved mappings.

On your computer
disconnect

Disconnect an appStop this local connection while retaining both documents and recovery history. Provider credentials are managed separately.

On your computer

The same catalog and preview rules are used by the app, CLI and MCP.

txt sync apps --jsontxt sync apps preview snapshots.jsonMCP: list-sync-apps · preview-app-sync