portable-text-conversion 是把 HTML、Markdown 或其他资料转成 Portable Text 的 Skill。Portable Text 用块、片段和标记保存结构,便于交给 Sanity 内容系统。
标题和列表不该全压成普通文字,链接注释与粗体标记也不同。手工构造时需保持块内引用和键对应;遇到图片等自定义内容,要确认目标模型能保存并渲染。
主文列三条转换路线,具体规则没有在本文展开。函数返回了结构,不等于内容已写入数据库;旧页面的格式、媒体和链接也需逐类比较,不能默认无损迁移。
适合先把目标结构说清,再选与来源匹配的解析方案。本文未转换资料或入库,包名和版本支持需另核;完成导入后还要看真实页面,不能只凭对象形状判断读者看到的内容。