skills.rest
KangOxford
KangOxfordCOMMUNITY
Explore all skills by this author →
GitHub

notion-push-via-rest

Convert Markdown blocks into Notion blocks and create child pages via REST API.

1|Updated Apr 23, 2026
Search Tags:#automation#markdown#integration#notion#rest-api#api-token
One-click install
npx skills add https://github.com/KangOxford/auto-quant-research --skill notion-push-via-rest
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: notion-push-via-rest
Source: https://github.com/KangOxford/auto-quant-research/tree/main/execution-layer/skills/notion-push-via-rest
Command: npx skills add https://github.com/KangOxford/auto-quant-research --skill notion-push-via-rest

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Notion-based teams often struggle to publish and synchronize status, reports, and documentation from Markdown sources when MCP OAuth issues block the built-in tooling. This Skill automates pushing Markdown content to a Notion page using REST API with an Internal Integration Token, providing a dependable one-way publishing path.

Core Features & Use Cases

  • Push Markdown content to a Notion page via REST API using an Internal Integration Token.
  • Convert Markdown blocks (headings, code, equations, tables) into Notion blocks, including support for inline KaTeX equations and fenced code blocks.
  • Batch submissions in groups of 100 blocks and create child pages under a configured parent page, with token management and error reporting.

Quick Start

Configure MD_PATH, PARENT, and TITLE, then run push_notion.py to publish your Markdown to Notion.

Frequently Asked Questions about notion-push-via-rest

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

FAQPage Schema
How do I push markdown content to a Notion page using the REST API?▼

To push markdown content to a Notion page, this skill converts markdown blocks into Notion blocks and creates a child page under a specified parent using a Notion internal integration token via the REST API.

Can I use an internal integration token to publish markdown reports to Notion when OAuth fails?▼

Yes, you can use an internal integration token to publish markdown reports to Notion, providing a dependable one-way publishing path that bypasses MCP OAuth issues blocking built-in tooling.

Does the Notion REST API skill support converting markdown elements like fenced code blocks and KaTeX equations?▼

The Notion REST API skill supports converting markdown elements including fenced code blocks, tables, headings, and inline KaTeX equations into corresponding native Notion blocks.

How do I configure the environment to automate sending markdown status updates to Notion?▼

To automate sending markdown status updates, store your Notion token in ~/.notion_token, define the MD_PATH, PARENT, and TITLE variables, then execute the push_notion.py script to publish.

What are the limitations when batching markdown blocks for the Notion API?▼

A limitation when batching markdown blocks for the Notion API is that submissions are processed in groups of 100 blocks, requiring proper formatting for Notion API v1 to handle large documents.

Related Skills

Explore More Content & Communication Skills→
Open330Open330
1

uploading-to-notion

Convert Markdown content into Notion blocks and create pages.

Official
Intermediate
DavidTejuDavidTeju
9

notion-child-page-preservation

Preserve Notion child pages during parent page block updates.

Community
Intermediate
hffmnnjhffmnnj
39

api-docs

Generate API reference documentation from OpenAPI specs and GraphQL schemas.

Community
Advanced
ThuHuynh1438ThuHuynh1438

notion

Search, publish, and sync vault notes with Notion pages and databases.

Community
Advanced