Portable Text 変換

外部コンテンツ (HTML、Markdown) を Sanity の Portable Text に変換します。3 つの主な手法：

1. markdownToPortableText — @portabletext/markdown を使用して Markdown を直接変換 (Markdown 向けに推奨)
2. htmlToBlocks — @portabletext/block-tools を使用して HTML を PT ブロックにパース (HTML マイグレーション向け)
3. 手動構築 — 任意のソース (API、データベース等) から PT ブロックを直接構築

Portable Text 仕様

変換前に対象フォーマットを理解してください。PT はブロックの配列です：

[
  {
    "_type": "block",
    "_key": "abc123",
    "style": "normal",
    "children": [
      {"_type": "span", "_key": "def456", "text": "Hello ", "marks": []},
      {"_type": "span", "_key": "ghi789", "text": "world", "marks": ["strong"]}
    ],
    "markDefs": []
  },
  {
    "_type": "block",
    "_key": "jkl012",
    "style": "h2",
    "children": [
      {"_type": "span", "_key": "mno345", "text": "A heading", "marks": []}
    ],
    "markDefs": []
  },
  {
    "_type": "image",
    "_key": "pqr678",
    "asset": {"_type": "reference", "_ref": "image-abc-200x200-png"}
  }
]

主なルール：

• すべてのブロックとスパンは _key が必要です (配列内でユニーク)
• _type: "block" はテキストブロック用です; カスタム型は独自の _type を使用します
• markDefs はアノテーションデータを保持します; スパン上の marks は markDefs[*]._key を参照するか、デコレーター文字列です
• リストは通常のブロック上に listItem ("bullet" | "number") と level (1, 2, 3...) を使用します

変換ルール

ソース形式に対応するルールファイルを参照してください：

• Markdown → Portable Text: rules/markdown-to-pt.md — @portabletext/markdown を使用した markdownToPortableText (推奨)
• HTML → Portable Text: rules/html-to-pt.md — @portabletext/block-tools を使用した htmlToBlocks
• 手動 PT 構築: rules/manual-construction.md — 任意のソースからプログラム的にブロックを構築

注記: @sanity/block-tools はレガシーパッケージ名です。新規プロジェクトでは常に @portabletext/block-tools を使用してください。API は同じです。