notion2vault
v1.0.0
Published
Convert your public Notion pages to Obsidian markdown — instantly.
Maintainers
Readme
notion2vault
Convert public Notion pages and databases into Obsidian-friendly markdown with local image downloads.
Features
- Export a published Notion page or database to markdown
- Download Notion image blocks into a local
assets/folder - Rewrite image references to Obsidian embeds like
![[assets/img_xxx.png]] - Keep one note per entry for published databases
- Support
--flatand--dry-run
Install
npm install -g notion2vaultOr run it without a global install:
npx notion2vault "<notion-url>" "<vault-path>"Usage
notion2vault "<notion-url>" "<vault-path>" [options]Examples:
notion2vault "https://your-workspace.notion.site/your-page-id?v=your-view-id" "~/Documents/Obsidian Vault"
notion2vault "https://your-workspace.notion.site/your-page-id" "~/Documents/Obsidian Vault/Inbox" --flat
notion2vault "https://your-workspace.notion.site/your-page-id" "~/Documents/Obsidian Vault" --dry-runOptions:
--flatwrites notes directly into the target folder--dry-runpreviews the export without writing files--no-titleavoids keeping a duplicated top-level note title-h, --helpshows the CLI help
Notes
- Quote both the Notion URL and the vault path in
zsh - The page must be publicly accessible
- Images are stored inside
assets/next to the exported markdown files
License
MIT
