skills.rest
DavidTeju
DavidTejuCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

notion-page-link-syntax

Normalize Notion MCP URLs and select page or mention-page tags for updates.

9|2|Updated Mar 5, 2026
Search Tags:#notion#url-validation#content-editing#notion-mcp#page-linking#mention-page
One-click install
npx skills add https://github.com/DavidTeju/shared-skills --skill notion-page-link-syntax
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: notion-page-link-syntax
Source: https://github.com/DavidTeju/shared-skills/tree/main/skills/notion-page-link-syntax
Command: npx skills add https://github.com/DavidTeju/shared-skills --skill notion-page-link-syntax

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Notion MCP URL validation errors occur when inserting links during updates, especially with braces-wrapped read URLs and unintended page moves.

Core Features & Use Cases

  • URL normalization: Use plain URLs for write/update operations to avoid validation errors.
  • Tag guidance: Choose between <page> (moves or creates a child) and <mention-page> (references without moving) to control page linking behavior.
  • Practical examples: Convert a read URL wrapped in braces to a proper write URL and reference an existing page without altering page structure.

Quick Start

Provide a Notion page URL and specify whether to reference or move it to update content correctly.

Frequently Asked Questions about notion-page-link-syntax

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

FAQPage Schema
Why does Notion MCP throw URL validation errors when inserting page links?▼

Notion MCP URL validation errors occur when inserting links during updates because read URLs wrapped in braces are used for write operations. Normalizing these to plain URLs prevents validation failures.

How do I reference a Notion page without moving it during an MCP update?▼

To reference a Notion page without moving it, use the <mention-page> tag instead of the <page> tag. This ensures the link points to the existing page without altering your page structure.

What is the difference between <page> and <mention-page> tags in Notion MCP?▼

The <page> tag moves or creates a child page, while the <mention-page> tag references an existing page without moving it. Choosing the correct tag controls whether the page structure changes during updates.

How do I convert a braces-wrapped read URL to a write URL for Notion MCP?▼

To convert a read URL for Notion MCP updates, remove the braces wrapping and use the plain URL format. This normalization allows the link to pass validation for write operations.

When should I not use the <page> tag for Notion page linking?▼

You should not use the <page> tag when you only need to link to an existing page without changing its location. Using it unnecessarily will move the page or create an unintended child page.

Related Skills

Explore More Content & Communication Skills→
storyclaw-officialstoryclaw-official

feishu-wiki

List and manage Feishu wiki spaces, nodes, and pages.

Official
Intermediate
LeooooooowLeooooooow
7

on-page-seo-auditor

Audit web pages for on-page SEO factors and generate prioritized fixes.

Community
Intermediate
zhayujiezhayujie
46.4k

web-fetch

Fetch web page HTML and extract title and readable text.

Community
Basic
changgengluchanggenglu

notion-mcp-handler

Resolve Notion MCP API validation and schema errors during page creation.

Community
Advanced