Does it support dry runs?

Yes, using the --dry-run flag allows you to verify the conversion and upload logic without actually modifying your Notion pages.

What are the prerequisites for using this skill?

You need a Notion Integration token configured in your environment, Python 3.9+, and the notion-image plugin installed.

Can I append content to an existing Notion page?

Yes, the skill includes an --append option to add content to the end of a page instead of replacing the existing content.

How do I find my Notion page ID?

The page ID is the 32-character string found at the end of your Notion page URL (e.g., the part after the last hyphen).

Does this skill handle images automatically?

Yes, the integrated command uploads local images and replaces placeholders in the Notion page automatically.

Markdown to Notion Uploader

Name: Markdown to Notion Uploader
Author: tktm04

bytktm04

•

Content Management

Uploads Markdown files containing text and images directly to Notion pages with automated block conversion and image hosting.

The Markdown to Notion Uploader skill streamlines the process of publishing local documentation, reports, and technical guides to Notion workspaces. It automatically parses Markdown files, converts them into Notion-compatible blocks, and handles the complex task of uploading local images and replacing placeholders. Designed for efficiency within Claude Code, it offers a single-command workflow to minimize token consumption while providing advanced options for dry runs, content appending, and granular control over text and image processing.

Key Features

01Granular control with separate text and image processing tools

02Relative link sanitization to prevent Notion API errors

032 GitHub stars

04Automatic local image upload and placeholder replacement

05Seamless Markdown-to-Notion block conversion

06Token-efficient single-command integration for Claude Code

Use Cases

01Publishing technical reports or READMEs from a local repository to a team Notion workspace.

02Migrating local documentation folders to Notion while maintaining image references.

03Automating periodic documentation updates to Notion using CLI workflows.

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add tktm04/tk-claude-plugins notion-markdown

For use in Claude.ai and ChatGPT

Download Skill