notion-formatter

Notion 格式整理器

快速入门

Notion 是一个基于块的编辑器，而不是纯 Markdown 系统。它支持标准 Markdown 的基本格式（标题、列表、粗体、斜体、行内代码），但许多功能需要使用 Notion 专属语法或手动创建。此技能可帮助你优化 Markdown 格式，以便导入 Notion：使用正确的语法、标注手动操作步骤，并提醒你注意相关限制。

核心工作流

1. 确定内容类型

• Claude 响应：将我刚生成的文本格式化，以便用于 Notion
• 文档：将现有 .md 文件转换为 Notion 格式
• 混合内容：包含图片、代码、表格的 Markdown

2. 使用标准 Markdown（适用于所有场景）

这些功能请使用标准 Markdown——粘贴到 Notion 时会自动转换：

**bold** _italic_ `inline code` ~strikethrough~

# Heading 1

## Heading 2

### Heading 3

- Bullet point
- Another point
  - Nested bullet

1. Numbered item
2. Second item

[] Checkbox item

3. 使用 Notion 专属语法

**关键区别：**折叠区段使用 >，引用块使用 "。有关所有功能的详细语法和示例，请参阅 REFERENCE.md。

快速语法：

> Toggle heading
> Hidden content here

" Blockquote text

code here

列 1	列 2
数据 1	数据 2

4. 标注手动操作步骤

对于需要在 Notion 中手动创建的功能，请添加标注：

• **公式：**使用 [NOTION: Recreate equation manually]
• **其他不支持的功能：**使用 [NOTION: Feature name here]

5. 检查输出

发送到 Notion 之前，请检查：

• 标准 Markdown 格式正确（标题、列表、格式）
• 折叠区段语法使用 >，后接空格（大于号加空格）
• 引用块使用 "，后接空格（引号加空格）
• 代码块带有语言标签
• 图片使用完整 URL，而非本地路径
• 表格使用管道符语法
• 手动操作步骤的标注清晰

示例

示例 1：格式化响应

如果我生成的响应包含代码和表格，请使用带语言标签的代码块和管道符语法表格进行格式化。

代码块示例：

# Example code
def process_data(items):
    return [x * 2 for x in items]

表格示例：

输入	输出
1	2
5	10

示例 2：转换文档

对于包含多个区段的文档，请使用折叠区段创建可折叠内容，格式为 > Section Title，并在下方缩进编写内容。

最佳实践

• **保持简洁：**避免过度嵌套
• **先测试表格：**如果表格较复杂，可以考虑在 Notion 中手动创建
• **图片 URL：**始终确认图片可在线访问
• **拆分大型文档：**如果文档无法一次性完整导入，请分段粘贴
• **手动润色：**粘贴后始终在 Notion 中检查，并修复多余的换行和语言检测问题

---

有关详细语法、注意事项和故障排除，请参阅 REFERENCE.md