SuperAPI AI Directory
Partner with us中文AI newsFavorites
Skillsnotion-markdown-conversion

notion-markdown-conversion

Office & productivity

View repository

Updated 10-15 17:33

About this skill

Notion to Markdown Conversion Skill

Use Notion MCP to retrieve Notion databases and pages, and convert them into highly AI-readable Markdown format.

Supported Tasks

  • Convert the entire structure of a Notion database into Markdown
  • Output the list of pages in the database in table format
  • Output the details of individual pages in Markdown format
  • Visualize the database schema
  • Format search results in Markdown format

Available MCP Tools

Data Retrieval

  • mcp__Notion__notion-search - Search all of Notion (semantic search)
  • mcp__Notion__notion-fetch - Retrieve a specific page or database

Data Writing (as needed)

  • mcp__Notion__notion-create-pages - Create a new page
  • mcp__Notion__notion-update-page - Update a page

Markdown Conversion Patterns

1. Converting Database Structure to Markdown

# Database: [Database Name]

## スキーマ

| プロパティ名 | タイプ | 説明 |
|------------|--------|------|
| Name | title | タイトルプロパティ |
| Status | select | ステータス選択 |
| Date | date | 日付 |

## ページ一覧

| Name | Status | Date | ... |
|------|--------|------|-----|
| ページ1 | 進行中 | 2026-01-06 | ... |
| ページ2 | 完了 | 2026-01-05 | ... |

2. Converting Individual Pages to Markdown

# [Page Title]

## メタデータ
- **作成日**: 2026-01-06
- **最終更新**: 2026-01-06
- **作成者**: User Name
- **ステータス**: draft/current

## プロパティ
- **Status**: 進行中
- **Date**: 2026-01-06
- **Tags**: tag1, tag2

## コンテンツ

[ページの本文をNotion-flavored Markdownで表示]

3. Converting Search Results to Markdown

## 検索結果: "{query}"

### ページ

| タイトル | タイプ | 最終更新 | URL |
|---------|--------|----------|-----|
| ... | ... | ... | ... |

### Databases

| タイトル | 説明 | URL |
|---------|------|-----|
| ... | ... | ... |

Data Retrieval Workflow

Retrieving an Entire Database

  1. mcp__Notion__notion-fetchRetrieve by specifying the database ID with
  2. Analyze the schema and data sources
  3. Retrieve the list of pages from each data source
  4. Convert to Markdown format

Page Search and Retrieval

  1. mcp__Notion__notion-searchSearch by keyword with
  2. Extract the page URL or ID from the search results
  3. mcp__Notion__notion-fetchRetrieve details with
  4. Convert to Markdown format

Retrieving Details of Individual Pages

  1. Specify the page URL or ID
  2. mcp__Notion__notion-fetchRetrieve with
  3. Use Notion-flavored Markdown as-is or format it

Structuring Rules

  1. Place metadata at the beginning - Creation date, update date, author, etc.
  2. Make properties explicit - Clearly display database properties
  3. Handling null values - Empty properties are[未設定]displayed as
  4. Date formatting - Convert from ISO format to a readable format
  5. Use of tables - List data must always be in table format
  6. Maintain hierarchical structure - Express the importance of information through heading levels
  7. Preserve URLs - Make the original Notion URL referenceable

Handling Notion-Specific Elements

Property type

  • title: Display as plain text
  • rich_text: Preserve Markdown formatting
  • number: Display as a number
  • select/multi_select: Display as tags or a list
  • date: Display in YYYY-MM-DD format
  • checkbox: Display as ✓/✗ or [x]/[ ]
  • url: Markdown link format
  • email: Markdown link format
  • phone: Plain text
  • files: List of file names and URLs
  • people: List of usernames
  • relation: Links to related pages
  • rollup: Display the aggregation result
  • formula: Display the calculation result

Block Elements

  • paragraph: Normal paragraph
  • heading: Expressed with # ## ###
  • bulleted_list: - List
  • numbered_list: 1. List
  • to_do: - [ ] Checklist
  • toggle: Collapsible section
  • quote: > quote
  • code: ```Language code block
  • table: Markdown table
  • database: Database reference

Precautions During Conversion

  1. Notion-flavored Markdown: Preserve Notion's extended Markdown syntax
  2. Handling custom tags: <custom data-type="..."> Appropriate conversion of tags
  3. Handling placeholders: Make template placeholders explicit
  4. Mention: Properly represent @user, @page, etc.
  5. URL extraction: Can extract page ID from Notion URL
  6. Draft vs Published: Specify the page status

URL format

Page URL

  • Standard format: https://notion.so/workspace/Page-Title-{page-id}
  • ID extraction: the last 32 characters (excluding hyphens) are the page ID

DatabaseURL

  • Standard format: https://notion.so/workspace/{database-id}
  • With view: https://notion.so/workspace/{database-id}?v={view-id}

Usage examples

Example 1: Retrieving an entire Database

「Task ManagementデータベースをMarkdown形式で出力して」
→ Database fetch + Schema解析 + ページ一覧取得 + Markdown変換

Example 2: Page search and conversion

「Notionで"ミーティング議事録"を検索してMarkdown化して」
→ Search + Fetch + Markdown変換

Example 3: Retrieving details of a specific page

「このNotionページをMarkdown形式で: https://notion.so/...」
→ Page fetch + Markdown変換

Example 4: List of pages in a Database

「プロジェクトデータベースの全ページをテーブルで表示」
→ Database fetch + ページ一覧取得 + Markdownテーブル生成

Best practices

  1. Step-by-step retrieval: First retrieve the Database schema, then retrieve details
  2. Using URLs: Passing a Notion URL as-is automatically extracts the ID
  3. Using search: If the title is unknown, start with search
  4. Cache: Save retrieved data to files appropriately
  5. Batch processing: Improve efficiency for multiple pages with parallel retrieval

References

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