notion-formatter

Notion フォーマッター

クイックスタート

Notion はブロックベースのエディターであり、純粋な Markdown システムではありません。基本的な書式設定（見出し、リスト、太字、斜体、インラインコード）には標準 Markdown を使用できますが、多くの機能には Notion 固有の構文や手動での作成が必要です。このスキルでは、適切な構文を適用し、手動で行う手順を注記し、制限事項について警告することで、Notion へのインポートに最適な形式に Markdown を整えます。

基本的なワークフロー

1. コンテンツの種類を特定する

• Claude の応答：Notion 向けに、今生成したテキストを整形する
• ドキュメント：既存の .md ファイルを Notion 形式に変換する
• 混在コンテンツ：画像、コード、表を含む Markdown

2. 標準 Markdown を適用する（どこでも使える機能）

Notion に貼り付けると自動的に変換される以下の機能には、標準 Markdown を使用します。

**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: 数式を手動で再作成] を使用します
• その他の未対応機能： [NOTION: ここに機能名] を使用します

5. 出力を確認する

Notion に送る前に、以下を確認します。

• 標準 Markdown が正しい（見出し、リスト、書式設定）
• トグルの構文で > の後にスペースを入れている（大なり記号とスペース）
• 引用ブロックで " の後にスペースを入れている（引用符とスペース）
• コードブロックに言語ラベルが付いている
• 画像にローカルパスではなく完全な URL を使用している
• 表にパイプ構文を使用している
• 手動で行う手順の注記が明確である

例

例 1：応答を整形する

コードと表を含む応答を生成した場合は、言語ラベル付きのコードブロックとパイプ構文の表を使って整形します。

コードブロックの例：

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

表の例：

入力	出力
1	2
5	10

例 2：ドキュメントを変換する

複数のセクションからなるドキュメントでは、> セクションタイトル と、その下にインデントしたコンテンツを使って、折りたたみ可能なセクションを作成します。

ベストプラクティス

• シンプルに保つ： 深くネストした構造は避けます
• まず表を試す： 表が複雑な場合は、Notion で手動作成することを検討します
• 画像 URL： 画像にオンラインでアクセスできることを必ず確認します
• 大きなドキュメントは分割する： ドキュメント全体をインポートできない場合は、分割して貼り付けます
• 手動で仕上げる： 貼り付け後は必ず Notion 上で確認し、余分な改行や言語の検出を修正します

---

詳細な構文、注意点、トラブルシューティングについては、REFERENCE.md を参照してください