将输入的HTML文本转换为思源笔记内部使用的块DOM（Document Object Model）结构。这对于需要将外部HTML内容导入并解析为思源块结构的场景非常有用。
| 参数名 | 类型 | 必选 | 描述 |
|---|---|---|---|
| html | string | 是 | 要转换的HTML文本 |
| id | string | 否 | 指定生成的根块ID（可选，若不提供则自动生成） |
| 参数名 | 类型 | 描述 |
|---|---|---|
| code | number | 返回码，0表示成功 |
| msg | string | 返回信息 |
| data | object | 转换后的块DOM结构 (JSON格式) |
| data.id | string | 根块ID |
| data.type | string | 根块类型 (通常是'NodeDocument') |
| data.children | array | 子块列表，每个子块包含ID, 类型, 内容, 属性等信息 |
POST /api/lute/html2BlockDOM HTTP/1.1
Host: 127.0.0.1:6806
Content-Type: application/json
Authorization: Token your-token
{
"html": "<h1>标题1</h1><p>段落内容。</p><ul><li>列表项</li></ul>"
}{
"code": 0,
"msg": "",
"data": {
"id": "20240418001000-abcdefg", // 示例ID，实际会生成
"type": "NodeDocument",
"children": [
{
"id": "20240418001000-hijklmn",
"type": "NodeHeading",
"spec": "h1",
"children": [
{
"type": "NodeText",
"text": {
"content": "标题1"
}
}
]
},
{
"id": "20240418001000-opqrstu",
"type": "NodeParagraph",
"children": [
{
"type": "NodeText",
"text": {
"content": "段落内容。"
}
}
]
},
{
"id": "20240418001000-vwxyz01",
"type": "NodeList",
"spec": "ul",
"children": [
{
"id": "20240418001000-2345678",
"type": "NodeListItem",
"children": [
{
"id": "20240418001000-9abcdef",
"type": "NodeParagraph",
"children": [
{
"type": "NodeText",
"text": {
"content": "列表项"
}
}
]
}
]
}
]
}
]
}
}注意：这是一个社区维护的文档，可能与官方最新版本存在差异。
如果您觉得本文档有帮助，可以考虑赞助支持：爱发电