Terminal
Terminal/Skill
Converts HTML and Markdown into Portable Text blocks for Sanity, useful when migrating or importing external content.
By Sanity
Works with
npx skills add sanity-io/agent-toolkit --skill portable-text-conversionConvert external content (HTML, Markdown) into Portable Text for Sanity. Three main approaches:
markdownToPortableText — Convert Markdown directly using @portabletext/markdown (recommended for Markdown)htmlToBlocks — Parse HTML into PT blocks using @portabletext/block-tools (for HTML migration)Understand the target format before converting. PT is an array of blocks:
[
{
"_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 rules:
_key (unique within the array)_type: "block" is for text blocks; custom types use their own _typemarkDefs holds annotation data; marks on spans reference markDefs[*]._key or are decorator stringslistItem ("bullet" | "number") and level (1, 2, 3...) on regular blocksRead the rule file matching your source format:
rules/markdown-to-pt.md — @portabletext/markdown with markdownToPortableText (recommended)rules/html-to-pt.md — @portabletext/block-tools with htmlToBlocksrules/manual-construction.md — build blocks programmatically from any sourceNote:
@sanity/block-toolsis the legacy package name. Always use@portabletext/block-toolsfor new projects. The API is the same.