Notion API: Markdown形式でページ内容を更新・置換する方法

従来のブロック（Block）ベースのAPIではなく、Markdown文字列をそのまま送信して更新・置換できる最新のやり方をまとめました。

1. 概要

Notion APIの 2026-03-11 バージョンから、ページ内容の操作にMarkdownがサポートされました。
これまでのように複雑なJSON配列を組み立てる必要がなく、非常にシンプルに実装できます。

• メソッド: PATCH
• エンドポイント: https://api.notion.com/v1/pages/:page_id/markdown

2. 実装例 (JavaScript / fetch)

ページ全体を完全に書き換える (replace_content)

既存の内容をすべて削除し、新しいMarkdownで上書きします。

const PAGE_ID = 'your_page_id';
const TOKEN = 'your_notion_token';

const replacePageContent = async () => {
  const response = await fetch(`https://api.notion.com/v1/pages/${PAGE_ID}/markdown`, {
    method: 'PATCH',
    headers: {
      'Authorization': `Bearer ${TOKEN}`,
      'Content-Type': 'application/json',
      'Notion-Version': '2026-03-11' // 最新バージョンを指定
    },
    body: JSON.stringify({
      type: 'replace_content',
      replace_content: {
        new_str: "# 新しいタイトル\n\n- 箇条書き1\n- 箇条書き2\n\n**太字**も簡単に使えます。"
      }
    })
  });

  const data = await response.json();
  console.log(data);
};

関連リンク：https://developers.notion.com/guides/data-apis/enhanced-markdown