让用户像改 Word 一样改 PDF：段落识别是前提

用户说「把这个字改掉」时，他要的不是改一个字符，而是像在 Word 里那样改一段话。而 PDF 里没有段落——只有一堆带坐标的字符。所以文字编辑的第一步不是「改」，是「还原」。

段落识别：把字符变成段落

ipdf_paragraph 这一组做的就是这件事：把页面文字识别为可编辑的段落，并支持读写文字与字符属性。4 个类、85 个方法，签名见段落的接口文档。

字符属性要能读，也要能写

• 读：字体、字号、颜色、粗体、斜体、上下标、对齐方式。
• 写：改文字的同时改属性。

第二件事是「改完看起来和原文一致」的技术前提。 如果只能改文字不能改属性，用户改完的字会立刻显眼：字体不一样、颜色不对、行距也变了。

这组接口能撑起哪些功能

• 页面上自由填写的文本（不是表单域那种）。
• 合同条款的措辞修改、报价单改数字、姓名更正。
• 你自己产品里的「所见即所得」PDF 编辑器。

自研时绕不过去的一件事

改完要让这一段重新排版。 PDF 的版面是按坐标固定的：字数一变，这一段的换行位置、行距甚至是否跨页都会变。段落识别给你的正是「这一段的边界在哪里」——没有它，你只能一个字符一个字符去挪。

常见问题

扫描件能编辑吗？

不能直接编辑——里面没有文字层。要先做 OCR 生成文字层，那是另一条链路。

能批量替换吗？

遍历段落逐处替换即可；具体接口以段落文档为准。

旋转过的页面上的文字呢？

文本层与段落层都按页面坐标系处理，旋转页同样可编辑。

怎么开始？

先申请试用，拿到接入文档后把「读出一个段落」跑通，再改它。

来源：知叶PDF 官方文档。能力范围以 SDK 接口文档为准，更新于 2026 年 9 月。