banana-sync-to-notion

Community

Sync Markdown to Notion with formatting.

AuthorTreyDong
Version1.0.0
Installs0

System Documentation

What problem does it solve?

Notion users and teams want to keep Markdown notes, docs, and project docs in sync with a Notion workspace while preserving folder structure and Markdown formatting, enabling seamless backup, migration, and collaboration.

Core Features & Use Cases

  • Recursive directory sync that preserves the original file hierarchy as nested Notion pages.
  • Full Markdown support: bold, italic, code, links, tables, and callouts are converted to native Notion blocks.
  • Automatic emoji icons based on filenames to visually organize content.
  • Incremental sync by skipping pages that already exist with the same title to avoid duplicates.
  • Relative link handling to connect inter-file references within Notion pages.
  • Notion API token and root page configuration via a .env file for secure deployments.

Quick Start

Configure a Notion integration by setting NOTION_TOKEN and NOTION_ROOT_PAGE_ID in a .env file, then run npm run sync:notion from the skill directory.

Dependency Matrix

Required Modules

None required

Components

scripts

💻 Claude Code Installation

Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.

Please help me install this Skill:
Name: banana-sync-to-notion
Download link: https://github.com/TreyDong/banana-skills/archive/main.zip#banana-sync-to-notion

Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
View Source Repository

Agent Skills Search Helper

Install a tiny helper to your Agent, search and equip skill from 223,000+ vetted skills library on demand.