feishu-wiki-tools/references/block_types.md

Docx Block 类型

常用块

type	block_type	说明	key 字段
text	2	普通文本	text.elements[].text_run
heading1	3	一级标题	heading1
heading2	4	二级标题	heading2
heading3	5	三级标题	heading3
bullet	12	无序列表	bullet
code	14	代码块	code
divider	22	分割线	divider

Text Element 属性

{
  "text_run": {
    "content": "文本内容",
    "text_element_style": {
      "bold": false,
      "link": {"url": "https://..."},
      "inline_code": false,
      "italic": false,
      "strikethrough": false,
      "underline": false
    }
  }
}

写入流程

1. GET /docx/v1/documents/{doc_id}/blocks/{doc_id} — 获取现有块
2. DELETE .../children/batch_delete — 清空默认块
3. POST .../children — 批量写入（≤25块/批）