Portable Text Conversion

Convert external content (HTML, Markdown) into Portable Text for Sanity. Three main approaches:

1. markdownToPortableText — Convert Markdown directly using @portabletext/markdown (recommended for Markdown)
2. htmlToBlocks — Parse HTML into PT blocks using @portabletext/block-tools (for HTML migration)
3. Manual construction — Build PT blocks directly from any source (APIs, databases, etc.)

Portable Text Specification

Understand the target format before converting. PT is an array of blocks: