Skip to content

Initial Release

Latest
Latest

Choose a tag to compare

View all tags
@urban233 urban233 released this 26 Jul 22:29
v0.1.0
a2083be

Safe Local Notion Export Ingestion

ntn-ingest is a local Go CLI for importing Notion Markdown-and-CSV ZIP exports into a protected Obsidian vault mirror.

Highlights

  • Imports local Notion ZIP exports without network access or credentials.
  • Preserves source files verbatim after ZIP safety validation.
  • Creates immutable external archive backups.
  • Produces SHA-256 manifests and deterministic change records.
  • Supports atomic reconciliation and crash recovery.
  • Includes configurable archive retention policies.
  • Provides human-readable and machine-readable JSON output.
  • Offers an optional MCP stdio server for archive and metadata management.
  • Protects curated vault content by limiting writes to managed source paths.

Requirements

  • Go 1.26.5 or later when building from source.
  • Windows amd64 is the primary supported platform.
  • A manually downloaded Notion Markdown-and-CSV ZIP export.
  • Separate vault and archive directories.

Important boundaries

This release does not access Notion over the network, manage authentication, invoke an LLM, modify curated wiki content, or provide a web-based service.
It is also known that there might be issues with overriding files instead of recognizing them as modified.

See the README for installation, configuration, command usage, recovery procedures, and development instructions.

Assets 3
Loading