工具

.hwp

.hwpx

说明

read_hwp

✅

✅

一次性获取正文 + 表格 (Markdown) + 图像列表

read_hwp_text

✅

✅

正文 + 页眉 + 页脚 + 脚注 + 公式集成文本

read_hwp_tables

✅

✅

将表格转换为 GitHub Markdown (处理单元格合并)

list_hwp_images

✅

✅

嵌入式图像列表 (mime, bytes)

extract_hwp_images

✅

✅

将图像提取到磁盘

工具

.hwp

.hwpx

说明

get_hwp_info

✅

✅

版本、页数、字体、表格/图像/脚注/公式统计

get_hwp_page_def

✅

✅

各节的纸张大小、页边距、分栏、页眉/页脚边距

list_hwp_fields

✅

✅

韩文域 (Field) 列表

get_hwp_field_value

✅

✅

查询域值

list_hwp_bindata

–

✅

.hwpx BinData/ 条目列表

工具

.hwp

.hwpx

说明

render_hwp_page

✅

✅

指定页面 → SVG (内联/文件)

render_hwp_all_pages

✅

✅

所有页面 SVG 批量处理

render_hwp_html

✅

✅

页面 → HTML

render_hwp_equation_svg

–

–

OWPML 公式脚本 → SVG

工具

.hwpx

说明

replace_hwp_text

✅

查找并替换特定字符串

fill_hwp_template

✅

填充 {{名称}} 等多个占位符

set_hwp_paragraph_text

✅

整体替换第 N 段文本

set_hwp_cell_text

✅

直接设置表格单元格 (行, 列) 文本

set_hwp_field_value

✅

设置域值

工具

.hwpx

说明

append_hwp_paragraph

✅

在正文末尾添加新段落

delete_hwp_paragraph

✅

删除第 N 段

append_hwp_table_row

✅

在表格末尾添加新行

delete_hwp_table_row

✅

删除表格行

append_hwp_table_column

✅

在表格末尾添加新列 (所有行)

delete_hwp_table_column

✅

删除表格列

merge_hwp_cells_horizontal

✅

水平合并单元格 (colSpan)

merge_hwp_cells_vertical

✅

垂直合并单元格 (rowSpan)

replace_hwp_image

✅

替换嵌入式图像

工具

.hwpx

说明

apply_hwp_text_style

✅

字体颜色、加粗、斜体、下划线、大小 (添加 charPr)

apply_hwp_paragraph_style

✅

段落对齐、缩进、行间距 (添加 paraPr)

工具

.hwpx

说明

insert_hwp_image

✅

添加新图像 (BinData + manifest + <hp:pic>)

delete_hwp_image

✅

删除 BinData/ 条目

insert_hwp_table

⚠️

插入新 OWPML 表格 (实验性 — 文件有效，rhwp 识别不完全)

create_hwpx_document

✅

用文本创建新的 .hwpx

内容

提取

备注

正文段落文本

✅

read_hwp_text, read_hwp

表格 (含单元格合并)

✅

read_hwp_tables 以 markdown 格式

嵌入式图像

✅

提取 PNG/JPG/BMP 等

页眉 / 页脚

✅

read_hwp_text 结果中包含 --- headers --- / --- footers --- 块

脚注 (footnote)

✅

结果末尾包含 --- footnotes --- 块，格式为 [1] 正文…

公式 (equation)

✅

OWPML 脚本格式 (例如: TIMES LEFT ( {a} over {b} RIGHT ))，--- equations --- 块

页面 SVG 渲染

✅

render_hwp_page

文本框正文

❌

rhwp 的 createShapeControl 可以创建，但 getTextBoxControlIndex 返回模式不明确 — v0.3 追踪

尾注 (endnote)

–

rhwp 本身不支持 (仅支持脚注)

图表 (chart)

❌

v0.3 之后

操作

.hwp

.hwpx

备注

单个文本替换

❌

✅

replace_hwp_text

填充多个占位符

❌

✅

fill_hwp_template

整体替换段落文本

❌

✅

set_hwp_paragraph_text

直接修改表格单元格

❌

✅

set_hwp_cell_text (指定行/列)

设置域值

❌

✅

set_hwp_field_value

添加 / 删除新段落

❌

✅

append_hwp_paragraph / delete_hwp_paragraph

添加 / 删除表格行

❌

✅

append_hwp_table_row / delete_hwp_table_row

替换 / 删除图像

❌

✅

replace_hwp_image / delete_hwp_image

创建新文档 (文本)

–

✅

create_hwpx_document

创建新文档 (表格)

–

⚠️

展平为文本行 (v0.3 中实现真正的 OWPML 表格)

插入新图像

❌

✅

insert_hwp_image

添加 / 删除表格列

❌

✅

append_hwp_table_column / delete_hwp_table_column

合并单元格 (水平/垂直)

❌

✅

merge_hwp_cells_horizontal / merge_hwp_cells_vertical

字体格式 (颜色/加粗/斜体/下划线/大小)

❌

✅

apply_hwp_text_style

段落格式 (对齐/缩进/行间距)

❌

✅

apply_hwp_paragraph_style

插入新表格 (真正的 OWPML)

❌

⚠️

insert_hwp_table (实验性)

新插入页眉/页脚

❌

❌

v0.3

图表/书签/样式定义

❌

❌

v0.3

领域

覆盖

读取/提取

~90%

渲染

~85% (SVG · HTML · 公式 SVG · Canvas 为浏览器专用，故排除)

写入 — 文本

~95%

写入 — 结构

~90% (行·列·合并·图像 4 种)

写入 — 格式

~70% (字体 + 段落)

元数据 / 域

~85%

整体加权

~85%