Back to Details

notion-markdown-conversion

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Notion to Markdown Conversion Skill

Notion转Markdown转换技能

Notion MCPを使用してNotionのdatabaseやページを取得し、AI可読性の高いMarkdown形式に変換します。
使用Notion MCP获取Notion数据库和页面，并将其转换为AI易读的Markdown格式。

対応タスク

支持的任务

  • Notion databaseの全体構造をMarkdown化
  • Database内のページ一覧をテーブル形式で出力
  • 個別ページの詳細をMarkdown形式で出力
  • Database schemaの可視化
  • 検索結果をMarkdown形式で整形
  • 将Notion数据库的整体结构转换为Markdown格式
  • 以表格形式输出数据库内的页面列表
  • 以Markdown格式输出单个页面的详细内容
  • 可视化Database Schema
  • 将搜索结果整理为Markdown格式

利用可能なMCPツール

可用的MCP工具

データ取得

数据获取

  • mcp__Notion__notion-search
    - Notion全体を検索（semantic search）
  • mcp__Notion__notion-fetch
    - 特定のページやdatabaseを取得
  • mcp__Notion__notion-search
    - 搜索整个Notion（语义搜索）
  • mcp__Notion__notion-fetch
    - 获取特定页面或数据库

データ書き込み（必要に応じて）

数据写入（按需使用）

  • mcp__Notion__notion-create-pages
    - 新規ページ作成
  • mcp__Notion__notion-update-page
    - ページ更新
  • mcp__Notion__notion-create-pages
    - 创建新页面
  • mcp__Notion__notion-update-page
    - 更新页面

Markdown変換パターン

Markdown转换模式

1. Database構造のMarkdown化

1. 数据库结构转Markdown

markdown
undefined
markdown
undefined

Database: [Database Name]

Database: [Database Name]

スキーマ

Schema

プロパティ名タイプ説明
Nametitleタイトルプロパティ
Statusselectステータス選択
Datedate日付
属性名类型说明
Nametitle标题属性
Statusselect状态选择
Datedate日期

ページ一覧

页面列表

NameStatusDate...
ページ1進行中2026-01-06...
ページ2完了2026-01-05...
undefined
NameStatusDate...
页面1进行中2026-01-06...
页面2已完成2026-01-05...
undefined

2. 個別ページのMarkdown化

2. 单个页面转Markdown

markdown
undefined
markdown
undefined

[Page Title]

[Page Title]

メタデータ

元数据

  • 作成日: 2026-01-06
  • 最終更新: 2026-01-06
  • 作成者: User Name
  • ステータス: draft/current
  • 创建日期: 2026-01-06
  • 最后更新: 2026-01-06
  • 创建者: User Name
  • 状态: draft/current

プロパティ

属性

  • Status: 進行中
  • Date: 2026-01-06
  • Tags: tag1, tag2
  • Status: 进行中
  • Date: 2026-01-06
  • Tags: tag1, tag2

コンテンツ

内容

[ページの本文をNotion-flavored Markdownで表示]
undefined
[页面正文以Notion风格Markdown显示]
undefined

3. 検索結果のMarkdown化

3. 搜索结果转Markdown

markdown
undefined
markdown
undefined

検索結果: "{query}"

搜索结果: "{query}"

ページ

页面

タイトルタイプ最終更新URL
............
标题类型最后更新URL
............

Databases

数据库

タイトル説明URL
.........
undefined
标题说明URL
.........
undefined

データ取得ワークフロー

数据获取工作流

Database全体の取得

获取整个数据库

  1. mcp__Notion__notion-fetch
    でdatabase IDを指定して取得
  2. Schemaとdata sourcesを解析
  3. 各data sourceからページ一覧を取得
  4. Markdown形式に変換
  1. 使用
    mcp__Notion__notion-fetch
    指定database ID进行获取
  2. 解析Schema和数据源
  3. 从各数据源获取页面列表
  4. 转换为Markdown格式

ページ検索と取得

页面搜索与获取

  1. mcp__Notion__notion-search
    でキーワード検索
  2. 検索結果からページURLまたはIDを抽出
  3. mcp__Notion__notion-fetch
    で詳細取得
  4. Markdown形式に変換
  1. 使用
    mcp__Notion__notion-search
    进行关键词搜索
  2. 从搜索结果中提取页面URL或ID
  3. 使用
    mcp__Notion__notion-fetch
    获取详细内容
  4. 转换为Markdown格式

個別ページの詳細取得

获取单个页面的详细内容

  1. ページURLまたはIDを指定
  2. mcp__Notion__notion-fetch
    で取得
  3. Notion-flavored Markdownをそのまま利用または整形
  1. 指定页面URL或ID
  2. 使用
    mcp__Notion__notion-fetch
    获取内容
  3. 直接使用或整理Notion风格Markdown

構造化ルール

结构化规则

  1. メタデータを先頭に配置 - 作成日、更新日、作成者など
  2. プロパティの明示 - Database propertiesを明確に表示
  3. null値の扱い - 空のプロパティは
    [未設定]
    と表示
  4. 日付の整形 - ISO形式から読みやすい形式に変換
  5. テーブルの活用 - 一覧データは必ずテーブル形式
  6. 階層構造の維持 - 見出しレベルで情報の重要度を表現
  7. URLの保持 - 元のNotion URLを参照可能にする
  1. 元数据前置 - 创建日期、更新日期、创建者等信息放在开头
  2. 明确属性 - 清晰显示Database属性
  3. 空值处理 - 空属性显示为
    [未设置]
  4. 日期格式化 - 将ISO格式转换为易读格式
  5. 使用表格 - 列表数据必须采用表格形式
  6. 保持层级结构 - 通过标题级别体现信息重要性
  7. 保留URL - 可查看原始Notion URL

Notion特有の要素の扱い

Notion特有元素的处理

プロパティタイプ

属性类型

  • title: プレーンテキストとして表示
  • rich_text: Markdownフォーマットを保持
  • number: 数値として表示
  • select/multi_select: タグまたはリストとして表示
  • date: YYYY-MM-DD形式で表示
  • checkbox: ✓/✗ または [x]/[ ] で表示
  • url: Markdownリンク形式
  • email: Markdownリンク形式
  • phone: プレーンテキスト
  • files: ファイル名とURLのリスト
  • people: ユーザー名のリスト
  • relation: 関連ページへのリンク
  • rollup: 集計結果を表示
  • formula: 計算結果を表示
  • title: 以纯文本显示
  • rich_text: 保留Markdown格式
  • number: 以数值显示
  • select/multi_select: 以标签或列表显示
  • date: 以YYYY-MM-DD格式显示
  • checkbox: 以✓/✗ 或 [x]/[ ] 显示
  • url: 以Markdown链接格式显示
  • email: 以Markdown链接格式显示
  • phone: 以纯文本显示
  • files: 显示文件名与URL列表
  • people: 显示用户名列表
  • relation: 显示关联页面链接
  • rollup: 显示汇总结果
  • formula: 显示计算结果

ブロック要素

块元素

  • paragraph: 通常の段落
  • heading: # ## ### で表現
  • bulleted_list: - リスト
  • numbered_list: 1. リスト
  • to_do: - [ ] チェックリスト
  • toggle: 折りたたみ可能セクション
  • quote: > 引用
  • code: ```言語 コードブロック
  • table: Markdownテーブル
  • database: Database参照
  • paragraph: 普通段落
  • heading: 用# ## ### 表示
  • bulleted_list: 用- 列表表示
  • numbered_list: 用1. 列表表示
  • to_do: 用- [ ] 复选列表表示
  • toggle: 可折叠章节
  • quote: 用> 引用表示
  • code: 用```语言 代码块表示
  • table: Markdown表格
  • database: 数据库引用

変換時の注意事項

转换注意事项

  1. Notion-flavored Markdown: Notionの拡張Markdown構文を保持
  2. カスタムタグの処理: 
    <custom data-type="...">
    タグの適切な変換
  3. プレースホルダーの扱い: テンプレートのプレースホルダーを明示
  4. メンション: @ユーザー、@ページ などを適切に表現
  5. URL抽出: Notion URLから page ID を抽出可能
  6. Draft vs Published: ページのステータスを明記
  1. Notion风格Markdown: 保留Notion的扩展Markdown语法
  2. 自定义标签处理: 正确转换
    <custom data-type="...">
    标签
  3. 占位符处理: 明确显示模板占位符
  4. 提及处理: 正确表示@用户、@页面等内容
  5. URL提取: 可从Notion URL中提取page ID
  6. 草稿与发布: 明确标注页面状态

URL形式

URL格式

ページURL

页面URL

  • 標準形式: 
    https://notion.so/workspace/Page-Title-{page-id}
  • ID抽出: 最後の32文字（ハイフン除く）がpage ID
  • 标准格式: 
    https://notion.so/workspace/Page-Title-{page-id}
  • ID提取: 最后32个字符（不含连字符）为page ID

DatabaseURL

数据库URL

  • 標準形式: 
    https://notion.so/workspace/{database-id}
  • View付き: 
    https://notion.so/workspace/{database-id}?v={view-id}
  • 标准格式: 
    https://notion.so/workspace/{database-id}
  • 带视图: 
    https://notion.so/workspace/{database-id}?v={view-id}

使用例

使用示例

例1: Database全体の取得

例1: 获取整个数据库

「Task ManagementデータベースをMarkdown形式で出力して」
→ Database fetch + Schema解析 + ページ一覧取得 + Markdown変換
「将Task Management数据库以Markdown格式输出」
→ 数据库获取 + Schema解析 + 页面列表获取 + Markdown转换

例2: ページ検索と変換

例2: 页面搜索与转换

「Notionで"ミーティング議事録"を検索してMarkdown化して」
→ Search + Fetch + Markdown変換
「在Notion中搜索"会议纪要"并转换为Markdown格式」
→ 搜索 + 获取 + Markdown转换

例3: 特定ページの詳細取得

例3: 获取特定页面的详细内容

「このNotionページをMarkdown形式で: https://notion.so/...」
→ Page fetch + Markdown変換
「将这个Notion页面转换为Markdown格式: https://notion.so/...」
→ 页面获取 + Markdown转换

例4: Database内のページ一覧

例4: 数据库内的页面列表

「プロジェクトデータベースの全ページをテーブルで表示」
→ Database fetch + ページ一覧取得 + Markdownテーブル生成
「以表格形式显示项目数据库的所有页面」
→ 数据库获取 + 页面列表获取 + Markdown表格生成

ベストプラクティス

最佳实践

  1. 段階的取得: まずDatabase schemaを取得してから詳細取得
  2. URLの活用: Notion URLをそのまま渡せば自動でID抽出
  3. 検索の活用: タイトルが不明な場合はsearchから開始
  4. キャッシュ: 取得したデータは適切にファイル保存
  5. バッチ処理: 複数ページは並列取得で効率化
  1. 分步获取: 先获取Database Schema再获取详细内容
  2. 利用URL: 直接传入Notion URL即可自动提取ID
  3. 利用搜索: 标题不明时从搜索开始
  4. 缓存: 将获取的数据适当保存为文件
  5. 批量处理: 多页面采用并行获取提升效率

参考資料

参考资料

  • Notion MCP Server Documentation
  • Notion-flavored Markdown Specification
  • Notion API Reference
  • Database Schema Types
  • Notion MCP Server Documentation
  • Notion-flavored Markdown Specification
  • Notion API Reference
  • Database Schema Types