Back to Details

notion-formatter

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Notion Formatter

Notion 格式化工具

Quick Start

快速开始

Notion is a block-based editor, not a pure markdown system. It supports standard markdown for basic formatting (headers, lists, bold, italic, inline code), but many features require Notion-specific syntax or manual creation. This skill helps you format markdown optimally for Notion import by applying the right syntax, annotating manual steps, and warning about limitations.
Notion是一个基于块的编辑器，而非纯Markdown系统。它支持标准Markdown用于基础格式设置（标题、列表、粗体、斜体、行内代码），但许多功能需要Notion特定语法或手动创建。本技能通过应用正确的语法、标注手动步骤并提示限制，帮助你将Markdown优化为适合Notion导入的格式。

Core Workflow

核心工作流程

1. Identify Your Content Type

1. 识别内容类型

  • Claude response: Formatting text I just generated for Notion
  • Documentation: Converting existing 
    .md
    files to Notion format
  • Mixed content: Markdown with images, code, tables
  • Claude生成的回复：为Notion格式化我刚生成的文本
  • 现有文档：将现有的
    .md
    文件转换为Notion格式
  • 混合内容：包含图片、代码、表格的Markdown内容

2. Apply Standard Markdown (What Works Everywhere)

2. 使用标准Markdown（通用兼容）

Use standard markdown for these features—they'll convert automatically when pasted into Notion:
markdown
**bold** _italic_ `inline code` ~strikethrough~
以下功能使用标准Markdown即可，粘贴到Notion时会自动转换：
markdown
**bold** _italic_ `inline code` ~strikethrough~

Heading 1

Heading 1

Heading 2

Heading 2

Heading 3

Heading 3

  • Bullet point
  • Another point
    • Nested bullet
  1. Numbered item
  2. Second item
[] Checkbox item
undefined
  • Bullet point
  • Another point
    • Nested bullet
  1. Numbered item
  2. Second item
[] Checkbox item
undefined

3. Use Notion-Specific Syntax

3. 使用Notion专属语法

Key distinction: Use 
>
for toggles (collapsible sections), 
"
for blockquotes. See REFERENCE.md for detailed syntax and examples of all features.
Quick syntax:
markdown
> Toggle heading
> Hidden content here

" Blockquote text
javascript
code here
Column 1Column 2
Data 1Data 2
alt
关键区别：使用
>
表示折叠块（可折叠区域），使用
"
表示引用块。所有功能的详细语法和示例请参考REFERENCE.md。
快速语法参考：
markdown
> 折叠块标题
> 隐藏内容在此处

" 引用块文本
javascript
code here
Column 1Column 2
Data 1Data 2
alt

4. Annotate Manual Steps

4. 标注手动步骤

Mark features that need manual creation in Notion with annotations:
  • Equations: Use 
    [NOTION: Recreate equation manually]
  • Other unsupported features: Use 
    [NOTION: Feature name here]
对需要在Notion中手动创建的功能添加标注：
  • 公式：使用
    [NOTION: 手动重新创建公式]
  • 其他不支持的功能：使用
    [NOTION: 此处填写功能名称]

5. Verify Output

5. 验证输出内容

Before sending to Notion, check:
  • Standard markdown is correct (headers, lists, formatting)
  • Toggle syntax uses 
    >
    followed by space (greater-than space)
  • Blockquotes use 
    "
    followed by space (quote space)
  • Code blocks have language labels
  • Images use full URLs, not local paths
  • Tables use pipe syntax
  • Manual step annotations are clear
发送到Notion之前，请检查：
  • 标准Markdown格式正确（标题、列表、格式设置）
  • 折叠块语法使用
    >
    加空格（大于号+空格）
  • 引用块使用
    "
    加空格（引号+空格）
  • 代码块带有语言标签
  • 图片使用完整URL，而非本地路径
  • 表格使用竖线语法
  • 手动步骤标注清晰

Examples

示例

Example 1: Formatting a Response

示例1：格式化回复内容

If I generate a response with code and a table, format it with language-labeled code blocks and pipe-syntax tables.
Code block example:
python
undefined
如果我生成了包含代码和表格的回复，需为其添加带语言标签的代码块和竖线语法表格。
代码块示例：
python
undefined

Example code

Example code

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

**Table example:**

| Input | Output |
| ----- | ------ |
| 1     | 2      |
| 5     | 10     |
def process_data(items): return [x * 2 for x in items]

**表格示例：**

| Input | Output |
| ----- | ------ |
| 1     | 2      |
| 5     | 10     |

Example 2: Converting Documentation

示例2：转换文档

For multi-section documents, use toggles to create collapsible sections with 
> Section Title
and content indented underneath.
对于多章节文档，使用折叠块创建可折叠区域，格式为
> 章节标题
，内容缩进在标题下方。

Best Practices

最佳实践

  • Keep it simple: Avoid deeply nested structures
  • Test tables first: If a table is complex, consider creating it manually in Notion
  • Image URLs: Always verify images are accessible online
  • Break large docs: Paste in chunks if a document fails to import entirely
  • Manual polish: Always review in Notion after paste—fix extra line breaks and language detection
For detailed syntax, gotchas, and troubleshooting, see REFERENCE.md
  • 保持简洁：避免深度嵌套结构
  • 先测试表格：如果表格复杂，建议在Notion中手动创建
  • 图片URL：始终验证图片可在线访问
  • 拆分大文档：如果文档导入失败，可分块粘贴
  • 手动优化：粘贴后务必在Notion中检查——修复多余换行和语言识别问题
如需详细语法、注意事项和故障排除方法，请查看REFERENCE.md