# 编辑 PDF

> 按页面、文本、表格、图片、分隔线、批注和原生文本选择对应的 PDF Facade 工作流。

- Human documentation: [https://docs.univer.ai/zh-CN/guides/pdfs/features/core/editing](https://docs.univer.ai/zh-CN/guides/pdfs/features/core/editing)

- Agent Markdown: [https://docs.univer.ai/zh-CN/guides/pdfs/features/core/editing.md](https://docs.univer.ai/zh-CN/guides/pdfs/features/core/editing.md)

- Requested language: `zh-CN`

- Content language: `zh-CN`

- Documentation version: `1.0.0-rc.0`

- Source: [pdfs/features/core/editing.zh-CN.mdx](https://github.com/dream-num/documentation/blob/dev/content/guides/pdfs/features/core/editing.zh-CN.mdx)

---

PDF 编辑 API 通过 Univer 命令执行；当操作具有逆操作时，会进入撤销与重做历史。请从与待修改内容对应的主题开始。

## 编辑主题

* [页面与元素](https://docs.univer.ai/zh-CN/guides/pdfs/features/core/pages-and-elements.md)：插入页面、枚举可编辑叠加层，以及变换、层叠、锁定和移除元素。
* [文本与列表](https://docs.univer.ai/zh-CN/guides/pdfs/features/core/text-and-lists.md)：编辑文本框、段落块和语义化列表。
* [表格](https://docs.univer.ai/zh-CN/guides/pdfs/features/core/tables.md)：插入与调整网格、更新单元格并应用主题。
* [图片与分隔线](https://docs.univer.ai/zh-CN/guides/pdfs/features/core/images-and-dividers.md)：插入托管图片和矢量分隔线。
* [批注与原生文本](https://docs.univer.ai/zh-CN/guides/pdfs/features/core/annotations-and-native-text.md)：添加受支持的批注并提升导入文本。

## 组合操作

```ts
const pdf = univerAPI.getActivePdf()
const page = pdf?.getPageByIndex(0)

if (!page) {
  throw new Error('No active PDF page')
}

const image = await page.insertImageAsync(
  'https://example.com/assets/signature.png',
  { left: 36, top: 36, width: 144, height: 72 }
)

image.setRotation(-4).bringToFront()
```

Facade 放置值使用 PDF 点。URL 图片应使用绝对 `http` 或 `https` 地址；自动源检测不接受相对 URL 路径。

单元创建、查找、保存与完整包装器总览请参阅 [Univer PDFs API](https://docs.univer.ai/zh-CN/guides/pdfs/features/core/pdfs-api.md)。