关于 notion-markdown-conversion
notion-markdown-conversion 是将 Notion 数据库、页面和搜索结果整理为结构化 Markdown 的技能。它通过 Notion MCP 工具获取内容，并保留元数据、属性、层级和链接，生成便于 AI 阅读的输出。
主要功能
- 01将数据库结构转为 Markdown
- 02以表格呈现页面列表
- 03整理单个页面内容
- 04展示数据库 Schema
- 05结构化搜索结果
适用场景
- 01导出数据库 Schema 和页面列表
- 02将 Notion 搜索结果整理为 Markdown
- 03准备便于 AI 阅读的 Notion 页面
MCP 相关
使用 Notion MCP 工具搜索和获取页面及数据库，必要时也可创建或更新页面。
安装
复制下面的命令，在终端中运行。
$
npx skills add https:/安装后在 Claude Code 中输入/notion-markdown-conversion确认已加载。
详细介绍
Notion 到 Markdown 转换技能
使用 Notion MCP 获取 Notion 数据库或页面，并将其转换为适合 AI 阅读的 Markdown 格式。
支持的任务
- 将 Notion 数据库的整体结构转换为 Markdown
- 以表格形式输出数据库中的页面列表
- 以 Markdown 格式输出单个页面的详细内容
- 可视化数据库架构
- 将搜索结果整理为 Markdown 格式
可用的 MCP 工具
数据获取
mcp__Notion__notion-search- 搜索整个 Notion（语义搜索）mcp__Notion__notion-fetch- 获取特定页面或数据库
数据写入（按需）
mcp__Notion__notion-create-pages- 创建新页面mcp__Notion__notion-update-page- 更新页面
Markdown 转换模式
1. 将数据库结构转换为 Markdown
# Database: [Database Name]
## スキーマ
| プロパティ名 | タイプ | 説明 |
|------------|--------|------|
| Name | title | タイトルプロパティ |
| Status | select | ステータス選択 |
| Date | date | 日付 |
## ページ一覧
| Name | Status | Date | ... |
|------|--------|------|-----|
| ページ1 | 進行中 | 2026-01-06 | ... |
| ページ2 | 完了 | 2026-01-05 | ... |
2. 将单个页面转换为 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. 将搜索结果转换为 Markdown
## 検索結果: "{query}"
### ページ
| タイトル | タイプ | 最終更新 | URL |
|---------|--------|----------|-----|
| ... | ... | ... | ... |
### Databases
| タイトル | 説明 | URL |
|---------|------|-----|
| ... | ... | ... |
数据获取工作流
获取整个数据库
- 使用
mcp__Notion__notion-fetch指定数据库 ID 并获取数据 - 分析架构和数据源
- 从各个数据源获取页面列表
- 转换为 Markdown 格式
搜索和获取页面
- 使用
mcp__Notion__notion-search搜索关键词 - 从搜索结果中提取页面 URL 或 ID
- 使用
mcp__Notion__notion-fetch获取详细内容 - 转换为 Markdown 格式
获取单个页面的详细内容
- 指定页面 URL 或 ID
- 使用
mcp__Notion__notion-fetch获取 - 直接使用或整理 Notion 风格的 Markdown
结构化规则
- 将元数据置于开头 - 如创建日期、更新日期、作者等
- 明确列出属性 - 清楚显示数据库属性
- 处理 null 值 - 将空属性显示为
[未设置] - 整理日期格式 - 将 ISO 格式转换为易读的格式
- 使用表格 - 列表数据必须使用表格形式
- 保留层级结构 - 通过标题级别表示信息的重要程度
- 保留 URL - 确保可以查看原始 Notion URL
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：显示计算结果
块元素
- paragraph：普通段落
- heading：用 # ## ### 表示
- bulleted_list：- 列表
- numbered_list：1. 列表
- to_do：- [ ] 检查清单
- toggle：可折叠区段
- quote：> 引用
- code：```语言 代码块
- table：Markdown 表格
- database：数据库引用
转换时的注意事项
- Notion 风格的 Markdown：保留 Notion 的扩展 Markdown 语法
- 自定义标签的处理：适当转换
<custom data-type="...">标签 - 占位符的处理：明确标示模板中的占位符
- 提及：适当表示 @用户、@页面 等
- 提取 URL：可以从 Notion URL 中提取 page ID
- 草稿与已发布：注明页面状态
URL 格式
页面 URL
- 标准格式：
https://notion.so/workspace/Page-Title-{page-id} - 提取 ID：末尾 32 个字符（不含连字符）为 page ID
数据库 URL
- 标准格式：
https://notion.so/workspace/{database-id} - 带视图：
https://notion.so/workspace/{database-id}?v={view-id}
使用示例
示例 1：获取整个数据库
「Task ManagementデータベースをMarkdown形式で出力して」
→ Database fetch + Schema解析 + ページ一覧取得 + Markdown変換
示例 2：搜索并转换页面
「Notionで"ミーティング議事録"を検索してMarkdown化して」
→ Search + Fetch + Markdown変換
示例 3：获取特定页面的详细内容
「このNotionページをMarkdown形式で: https://notion.so/...」
→ Page fetch + Markdown変換
示例 4：列出数据库中的页面
「プロジェクトデータベースの全ページをテーブルで表示」
→ Database fetch + ページ一覧取得 + Markdownテーブル生成
最佳实践
- 分步获取：先获取数据库架构，再获取详细内容
- 使用 URL：直接传入 Notion URL 即可自动提取 ID
- 使用搜索：标题不明确时，从搜索开始
- 缓存：将获取的数据妥善保存到文件
- 批处理：并行获取多个页面以提高效率
参考资料
- Notion MCP 服务文档
- Notion 风格的 Markdown 规范
- Notion API 参考
- 数据库架构类型
评论
支持 Markdown