Was macht nsync?
Notion-Synchronisationstool – Klone, synchronisiere und übertrage Notion-Seiten als lokales Markdown. Keine Abhängigkeiten. Kompatibel mit Claude Skill.
Übersicht
Dieses Tool ermöglicht es dir, Notion-Seiten als Markdown-Dateien lokal zu klonen, Änderungen zu synchronisieren und lokale Änderungen zurück nach Notion zu pushen. Es ist ideal für Entwickler, die Notion für Dokumentation oder Wissensmanagement nutzen und Inhalte in git-basierten Workflows oder KI-Agenten wie Claude Code bearbeiten möchten.
Voraussetzungen
- Node.js (v14 oder höher) oder Python 3.6+
- Ein Notion-Integrationstoken
- Die ID der zu synchronisierenden Notion-Seite oder -Datenbank
Installation
npm install -g @miyatti777/nsync
Oder mit Python:
pip install nsync
Verwendung
Klonen einer Notion-Seite
nsync clone <page-id> --output ./notion-pages
Synchronisieren lokaler Änderungen
nsync push <page-id> --input ./notion-pages
Hilfe anzeigen
nsync --help
Konfiguration
Erstelle eine .env-Datei im Stammverzeichnis:
NOTION_TOKEN=dein_notion_integrationstoken
NOTION_PAGE_ID=deine_notion_seiten_id
OUTPUT_DIR=./notion-pages
Funktionsweise
- Klonen: Lädt eine Notion-Seite oder Datenbank herunter und konvertiert sie in Markdown-Dateien (mit YAML-Frontmatter für Metadaten wie Titel, Erstellungsdatum, Tags).
- Synchronisieren: Vergleicht lokale Markdown-Dateien mit Notion-Inhalten und überträgt Änderungen.
- Pushen: Sendet lokale Markdown-Änderungen zurück an Notion unter Beibehaltung der Struktur.
Unterstützte Notion-Blöcke
- Überschriften (H1, H2, H3)
- Absätze
- Aufzählungen (geordnet/ungeordnet)
- Codeblöcke
- Tabellen
- Aufrufe (Callouts)
- Bilder (als Links)
Kompatibilität mit Claude Skill
Dieses Tool ist als Claude Skill konfigurierbar. Füge es als benutzerdefiniertes Tool in deiner Claude-Konfiguration hinzu, um Notion-Daten direkt in KI-gestützten Workflows zu nutzen.
Beispiel für die Claude-Konfiguration:
{
"name": "nsync",
"description": "Klont, synchronisiert oder pusht Notion-Seiten als lokales Markdown.",
"command": "nsync"
}
Lizenz
MIT