---
name: Add Text Watermark
slug: add-text-watermark
category: Automation
description: Add Text Watermark adds text watermarks to PDF files with custom font, size, color, and position. Use it when you need to mark a PDF with labels like confidential or draft.
github: "https://github.com/CoderWanFeng/python-office/tree/develop/skills/pdf/add_text_watermark"
language: Python
stars: 1339
forks: 301
install: "npx degit https://github.com/CoderWanFeng/python-office/tree/develop/skills/pdf/add_text_watermark ~/.claude/skills/add_text_watermark"
installs_to: ~/.claude/skills/add_text_watermark
source_path: skills/pdf/add_text_watermark/SKILL.md
collection_size: 50
category_size: 1523
collection_url: "https://dirskills.com/collections/CoderWanFeng/python-office"
added: 2026-08-12T04:43:07.104Z
last_synced: 2026-08-12T04:43:07.104Z
canonical_url: "https://dirskills.com/skills/add-text-watermark"
---

# Add Text Watermark

Add Text Watermark adds text watermarks to PDF files with custom font, size, color, and position. Use it when you need to mark a PDF with labels like confidential or draft.

**Install:**

```bash
npx degit https://github.com/CoderWanFeng/python-office/tree/develop/skills/pdf/add_text_watermark ~/.claude/skills/add_text_watermark
```

## README

# add_text_watermark Skill

> 在 PDF 文档中添加文本水印

## 功能描述

向 PDF 文档添加文本水印，可自定义位置、字体、字号、颜色等参数。

## 所属分类

`office/skills/pdf/add_text_watermark/`

## 调用方式

```python
from skills.pdf import add_text_watermark

add_text_watermark(
    input_file='./test.pdf',
    point=(100, 200),
    text='python-office',
    output_file='./with_watermark.pdf',
    fontname='Helvetica',
    fontsize=12,
    color=(1, 0, 0)
)
```

## 参数说明

| 参数 | 类型 | 必填 | 默认值 | 说明 |
|------|------|------|--------|------|
| `input_file` | str | 否 | - | PDF 文件路径 |
| `point` | tuple | 否 | - | 水印位置坐标 |
| `text` | str | 否 | `'python-office'` | 水印文本内容 |
| `output_file` | str | 否 | `'./pdf_watermark.pdf'` | 输出 PDF 文件路径 |
| `fontname` | str | 否 | `'Helvetica'` | 字体名称 |
| `fontsize` | int | 否 | `12` | 字体大小 |
| `color` | tuple | 否 | `(1, 0, 0)` | 字体颜色（RGB） |

## 返回值

`None`

## 使用示例

```python
from skills.pdf import add_text_watermark
add_text_watermark(input_file='./report.pdf', text='机密文件')
```

## 视频教程

https://www.python4office.cn/python-office/popdf/%E8%AF%BE%E7%A8%8B/7-add_watermark

## 原始函数

`office.api.pdf.add_text_watermark`
