skills.rest
42hz-ai
42hz-aiOFFICIAL
Explore all skills by this author →
GitHub

doc-upsert

Synchronize local Markdown files into Notion databases with link rewriting.

Updated May 1, 2026
Search Tags:#documentation#markdown#content management#synchronization#notion
One-click install
npx skills add https://github.com/42hz-ai/42hz-hardware-sbc-config --skill doc-upsert
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: doc-upsert
Source: https://github.com/42hz-ai/42hz-hardware-sbc-config/tree/main/.cursor/skills/doc-upsert
Command: npx skills add https://github.com/42hz-ai/42hz-hardware-sbc-config --skill doc-upsert

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill enables users to automatically push local Markdown files into a Notion database, maintaining synchronization and updating content efficiently.

Core Features & Use Cases

  • Notion Upsert: Create or update Notion pages from local Markdown files based on filename patterns.
  • Link Reconciliation: Convert repo-relative links to Notion URLs or GitHub fallbacks, ensuring consistent referencing.
  • Use Case: For technical documentation teams, keep project documentation in GitHub and sync it with Notion for easy access and collaboration.

Quick Start

Run the script with the path to your Markdown file to sync your documentation to Notion.

Frequently Asked Questions about doc-upsert

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I sync local Markdown documents with a Notion database?▼

The script creates or updates Notion pages from local Markdown files based on filename patterns. It automates content updates and metadata management to keep your technical knowledge base current.

How does link reconciliation work when pushing Markdown files to Notion?▼

Link reconciliation converts repo-relative links into Notion URLs or GitHub fallbacks during synchronization. This ensures consistent referencing across your project documentation after it is pushed to the Notion database.

Do I need a specific Notion database schema to synchronize Markdown files?▼

Yes, syncing Markdown files requires proper Notion database schema configuration and Notion API integration. You must configure the database schema beforehand to ensure correct content mapping and metadata management.

What is the best way to keep GitHub project documentation synced with Notion?▼

The best way to keep GitHub project documentation synced with Notion is using an automated upsert script. It updates Notion pages from local Markdown files, enabling easy access and collaboration for technical teams.

Can I update existing Notion pages from local Markdown files without creating duplicates?▼

Yes, the Notion upsert feature creates or updates Notion pages from local Markdown files based on filename patterns. This prevents duplicates by intelligently matching and updating existing content during synchronization.

Related Skills

Explore More Content & Communication Skills→
VegaStackVegaStack

notion-markdown-sync

Synchronize local markdown files with Notion pages bi-directionally.

Official
Advanced
JongsixJongsix

moai-docs-generation

Generate technical documentation from source code and API definitions.

Community
Advanced
thomfilgthomfilg

create-jira-wiki

Automate publishing design documents to Jira Wiki with Git version control.

Community
Intermediate
brainbrewlabsbrainbrewlabs
7

doc-publishing

Publishes documentation to GitHub Pages, Vercel, or Netlify from source docs and build outputs.

Official
Intermediate