# Add Watermark By Parameters

> 通过参数化方式给 PDF 添加水印。当用户提到参数化 PDF 水印、批量 PDF 水印时使用。

- Skill: `coderwanfeng/add-watermark-by-parameters` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add coderwanfeng/add-watermark-by-parameters`
- Raw SKILL.md: https://api.skillmd.com/api/skills/coderwanfeng/add-watermark-by-parameters/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing
- Author: coderwanfeng (https://skillmd.com/u/coderwanfeng)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/coderwanfeng/add-watermark-by-parameters

---


# add_watermark_by_parameters Skill

> 给 PDF 添加水印（带参数）

## 功能描述

通过参数化方式给 PDF 添加水印，与 `add_mark` 类似。

## 所属分类

`office/skills/pdf/add_watermark_by_parameters/`

## 调用方式

```python
from skills.pdf import add_watermark_by_parameters

add_watermark_by_parameters(
    input_file='./test.pdf',
    mark_str='python-office',
    output_path='./',
    output_file='watermarked.pdf'
)
```

## 参数说明

| 参数 | 类型 | 必填 | 默认值 | 说明 |
|------|------|------|--------|------|
| `input_file` | str | 否 | - | PDF 文件路径 |
| `mark_str` | str | 否 | - | 水印内容 |
| `output_path` | str | 否 | - | 输出路径 |
| `output_file` | str | 否 | - | 输出文件名 |
| `pdf_file` | str | 否 | - | **[已弃用]** 请使用 `input_file` |
| `output_file_name` | str | 否 | - | **[已弃用]** 请使用 `output_file` |

## 返回值

`None`

## 使用示例

```python
from skills.pdf import add_watermark_by_parameters
add_watermark_by_parameters(input_file='./report.pdf', mark_str='机密')
```

## 原始函数

`office.api.pdf.add_watermark_by_parameters`