A powerful synchronization engine that converts local Markdown files and Obsidian vaults into rich, structured Notion database pages.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install obsidian-notion
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install obsidian-notion using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Markdown to Notion Sync Skill?
The Markdown to Notion Sync Skill is a specialized tool designed to bridge the gap between local Markdown-based note-taking and Notion's collaborative environment. It enables developers and researchers to maintain a single source of truth by automatically pushing local edits to a Notion database while preserving complex formatting like tables, callouts, and mathematical formulas.
This skill is particularly valuable for users of Obsidian or other local PKM (Personal Knowledge Management) systems who want to leverage Notion's database capabilities for task management, project tracking, or public sharing without manual copy-pasting. It ensures that every Openclaw Skills deployment can handle sophisticated document transformations seamlessly.
Markdown to Notion Sync Skill Use Cases
- Synchronizing Obsidian vault folders to a centralized Notion research database.
- Publishing technical documentation or blog posts written in Markdown directly to Notion.
- Automating the archival of daily journals from local files to a structured Notion timeline.
- Managing academic papers and reading notes with automatic tag and status mapping.
How Markdown to Notion Sync Skill Works
- The script scans designated local directories for Markdown files, excluding specified templates or READMEs.
- It scrapes existing Notion database entries to create a title-to-ID cache for intelligent updating.
- Markdown content is parsed and pre-processed to remove frontmatter and sanitize HTML tags.
- Complex Markdown elements are mapped to native Notion Blocks (e.g., info callouts become blue-background blocks with lightbulb emojis).
- An 'Upsert' logic is applied: if a page with the same title exists, it is moved to the trash to ensure the new version is a clean, up-to-date replacement.
Markdown to Notion Sync Skill Setup
To get started with this Openclaw Skills integration, configure your environment variables in the sync script:
# 1. Edit the configuration in scripts/sync.py
vim scripts/sync.py
# Update the following variables:
# NOTION_KEY = "your-internal-integration-token"
# DB_ID = "your-database-id"
# OBSIDIAN_ROOT = "/path/to/your/vault"
# 2. Run the synchronization
python3 scripts/sync.py
Markdown to Notion Sync Skill Data Schema & Taxonomy
The skill requires a Notion database with a specific property schema to function correctly. Ensure your target database includes these exact fields:
| Property Name | Type | Description |
|---|---|---|
| Name | title | The page title (from filename) |
| Date | date | YYYY-MM-DD format |
| Note Category | select | Primary folder classification |
| Tags | multi_select | Extracted keywords |
| Status | select | Organization state (e.g., Archived) |
Markdown to Notion Sync Skill Advanced Features
- Automatic Upsert Logic: Prevents duplicate entries by archiving old versions before inserting new content.
- Rich Callout Support: Supports GitHub-style alerts like [!info], [!tip], and [!warning] with color-coded Notion callouts.
- Intelligent Code Handling: Automatically maps shorthand language codes (py, js, c++) to official Notion syntax highlighter languages.
- Math Equation Rendering: Converts standard LaTeX ($...$ and $$...$$) into native Notion equation blocks.
- Error Resilience: Includes built-in handling for block length limits (2000 characters) and Notion API rate constraints.
SKILL.md
Loading
Related Openclaw Skills
Dev Test: Development & Testing SOP
A disciplined, multi-phase development and testing Standard Operating Procedure (SOP) for implementing high-quality code changes.
VIP Search Assistant
A specialized tool for searching and extracting product data from VIP.com using authenticated API requests.
doc-converter
A high-fidelity document converter for seamless transitions between Word, PDF, Markdown, and HTML formats.
Daily News Brief
An automated news aggregation and AI summarization tool that delivers personalized daily briefings to messaging platforms.
Bidding Project Analysis Skill
An intelligent automation tool for extracting bidding data from Excel, managing it via MySQL, and generating insightful project reports.
MOVA Connector Setup
A powerful integration tool that replaces MOVA sandbox mocks with live production data from your own business systems.
Featured*
