设计与多媒体

用 Python 库和命令行工具读取、提取、合并、拆分、旋转、加水印、加密和生成 PDF。

它能做什么

这份指南围绕 Python 库(pypdf、pdfplumber、reportlab)和命令行工具(pdftotext、qpdf、pdftk、pdfimages)组织,给出可直接运行的代码片段:合并、拆分、旋转页面,提取文本与表格,读取元数据,新建 PDF,添加水印,设置密码,导出图片,以及用 pytesseract 配合 pdf2image 对扫描件做 OCR。表格提取示例可以汇总成 pandas DataFrame 并导出为 Excel。表单填写另见 FORMS.md,pypdfium2 进阶用法和 pdf-lib 等 JavaScript 库另见 REFERENCE.md。

什么时候用它

  • 把多个 PDF 合并成一个文件,或按页拆分成多个文件
  • 从报告里提取文本或表格,并把表格导出成 Excel
  • 用 reportlab 生成新的 PDF 报告,包括多页排版
  • 对扫描版 PDF 做 OCR,让文字可以检索

技能文档

PDF Processing Guide

Overview

This guide covers essential PDF processing operations using Python libraries and command-line tools. For advanced features, JavaScript libraries, and detailed examples, see REFERENCE.md. If you need to fill out a PDF form, read FORMS.md and follow its instructions.

Quick Start

from pypdf import PdfReader, PdfWriter

# Read a PDF
reader = PdfReader("document.pdf")
print(f"Pages: {len(reader.pages)}")

# Extract text
text = ""
for page in reader.pages:
    text += page.extract_text()

Python Libraries

pypdf - Basic Operations

Merge PDFs

from pypdf import PdfWriter, PdfReader

writer = PdfWriter()
for pdf_file in ["doc1.pdf", "doc2.pdf", "doc3.pdf"]:
    reader = PdfReader(pdf_file)
    for page in reader.pages:
        writer.add_page(page)

with open("merged.pdf", "wb") as output:
    writer.write(output)

Split PDF

reader = PdfReader("input.pdf")
for i, page in enumerate(reader.pages):
    writer = PdfWriter()
    writer.add_page(page)
    with open(f"page_{i+1}.pdf", "wb") as output:
        writer.write(output)

Extract Metadata

reader = PdfReader("document.pdf")
meta = reader.metadata
print(f"Title: {meta.title}")
print(f"Author: {meta.author}")
print(f"Subject: {meta.subject}")
print(f"Creator: {meta.creator}")

Rotate Pages

reader = PdfReader("input.pdf")
writer = PdfWriter()

page = reader.pages[0]
page.rotate(90)  # Rotate 90 degrees clockwise
writer.add_page(page)

with open("rotated.pdf", "wb") as output:
    writer.write(output)

pdfplumber - Text and Table Extraction

Extract Text with Layout

import pdfplumber

with pdfplumber.open("document.pdf") as pdf:
    for page in pdf.pages:
        text = page.extract_text()
        print(text)

Extract Tables

with pdfplumber.open("document.pdf") as pdf:
    for i, page in enumerate(pdf.pages):
        tables = page.extract_tables()
        for j, table in enumerate(tables):
            print(f"Table {j+1} on page {i+1}:")
            for row in table:
                print(row)

Advanced Table Extraction

import pandas as pd

with pdfplumber.open("document.pdf") as pdf:
    all_tables = []
    for page in pdf.pages:
        tables = page.extract_tables()
        for table in tables:
            if table:  # Check if table is not empty
                df = pd.DataFrame(table[1:], columns=table[0])
                all_tables.append(df)

# Combine all tables
if all_tables:
    combined_df = pd.concat(all_tables, ignore_index=True)
    combined_df.to_excel("extracted_tables.xlsx", index=False)

reportlab - Create PDFs

Basic PDF Creation

from reportlab.lib.pagesizes import letter
from reportlab.pdfgen import canvas

c = canvas.Canvas("hello.pdf", pagesize=letter)
width, height = letter

# Add text
c.drawString(100, height - 100, "Hello World!")
c.drawString(100, height - 120, "This is a PDF created with reportlab")

# Add a line
c.line(100, height - 140, 400, height - 140)

# Save
c.save()

Create PDF with Multiple Pages

from reportlab.lib.pagesizes import letter
from reportlab.platypus import SimpleDocTemplate, Paragraph, Spacer, PageBreak
from reportlab.lib.styles import getSampleStyleSheet

doc = SimpleDocTemplate("report.pdf", pagesize=letter)
styles = getSampleStyleSheet()
story = []

# Add content
title = Paragraph("Report Title", styles['Title'])
story.append(title)
story.append(Spacer(1, 12))

body = Paragraph("This is the body of the report. " * 20, styles['Normal'])
story.append(body)
story.append(PageBreak())

# Page 2
story.append(Paragraph("Page 2", styles['Heading1']))
story.append(Paragraph("Content for page 2", styles['Normal']))

# Build PDF
doc.build(story)

Subscripts and Superscripts

IMPORTANT: Never use Unicode subscript/superscript characters (₀₁₂₃₄₅₆₇₈₉, ⁰¹²³⁴⁵⁶⁷⁸⁹) in ReportLab PDFs. The built-in fonts do not include these glyphs, causing them to render as solid black boxes.

Instead, use ReportLab's XML markup tags in Paragraph objects:

from reportlab.platypus import Paragraph
from reportlab.lib.styles import getSampleStyleSheet

styles = getSampleStyleSheet()

# Subscripts: use  tag
chemical = Paragraph("H2O", styles['Normal'])

# Superscripts: use  tag
squared = Paragraph("x2 + y2", styles['Normal'])

For canvas-drawn text (not Paragraph objects), manually adjust font the size and position rather than using Unicode subscripts/superscripts.

Command-Line Tools

pdftotext (poppler-utils)

# Extract text
pdftotext input.pdf output.txt

# Extract text preserving layout
pdftotext -layout input.pdf output.txt

# Extract specific pages
pdftotext -f 1 -l 5 input.pdf output.txt  # Pages 1-5

qpdf

# Merge PDFs
qpdf --empty --pages file1.pdf file2.pdf -- merged.pdf

# Split pages
qpdf input.pdf --pages . 1-5 -- pages1-5.pdf
qpdf input.pdf --pages . 6-10 -- pages6-10.pdf

# Rotate pages
qpdf input.pdf output.pdf --rotate=+90:1  # Rotate page 1 by 90 degrees

# Remove password
qpdf --password=mypassword --decrypt encrypted.pdf decrypted.pdf

pdftk (if available)

# Merge
pdftk file1.pdf file2.pdf cat output merged.pdf

# Split
pdftk input.pdf burst

# Rotate
pdftk input.pdf rotate 1east output rotated.pdf

Common Tasks

Extract Text from Scanned PDFs

# Requires: pip install pytesseract pdf2image
import pytesseract
from pdf2image import convert_from_path

# Convert PDF to images
images = convert_from_path('scanned.pdf')

# OCR each page
text = ""
for i, image in enumerate(images):
    text += f"Page {i+1}:\n"
    text += pytesseract.image_to_string(image)
    text += "\n\n"

print(text)

Add Watermark

from pypdf import PdfReader, PdfWriter

# Create watermark (or load existing)
watermark = PdfReader("watermark.pdf").pages[0]

# Apply to all pages
reader = PdfReader("document.pdf")
writer = PdfWriter()

for page in reader.pages:
    page.merge_page(watermark)
    writer.add_page(page)

with open("watermarked.pdf", "wb") as output:
    writer.write(output)

Extract Images

# Using pdfimages (poppler-utils)
pdfimages -j input.pdf output_prefix

# This extracts all images as output_prefix-000.jpg, output_prefix-001.jpg, etc.

Password Protection

from pypdf import PdfReader, PdfWriter

reader = PdfReader("input.pdf")
writer = PdfWriter()

for page in reader.pages:
    writer.add_page(page)

# Add password
writer.encrypt("userpassword", "ownerpassword")

with open("encrypted.pdf", "wb") as output:
    writer.write(output)

Quick Reference

TaskBest ToolCommand/Code
Merge PDFspypdfwriter.add_page(page)
Split PDFspypdfOne page per file
Extract textpdfplumberpage.extract_text()
Extract tablespdfplumberpage.extract_tables()
Create PDFsreportlabCanvas or Platypus
Command line mergeqpdfqpdf --empty --pages ...
OCR scanned PDFspytesseractConvert to image first
Fill PDF formspdf-lib or pypdf (see FORMS.md)See FORMS.md

Next Steps

  • For advanced pypdfium2 usage, see REFERENCE.md
  • For JavaScript libraries (pdf-lib), see REFERENCE.md
  • If you need to fill out a PDF form, follow the instructions in FORMS.md
  • For troubleshooting guides, see REFERENCE.md

常见问题

用到哪些库和工具?
基础页面操作用 pypdf,文本和表格提取用 pdfplumber,生成 PDF 用 reportlab,OCR 用 pytesseract 配合 pdf2image。命令行方面涉及 pdftotext、qpdf、pdftk 和 pdfimages。
能填写 PDF 表单吗?
指南把表单填写指向单独的 FORMS.md,并提到可用 pdf-lib 或 pypdf,但具体的填写步骤不在本文档中。
包含 JavaScript 相关内容吗?
只是引用。文档说明 pypdfium2 进阶用法和 pdf-lib 等 JavaScript 库写在 REFERENCE.md 里,正文没有展开。

相关技能

以 AI 机器人身份加入视频会议,提供语音、虚拟形象与屏幕共享四种模式。

作者 johnpatternai22 次安装8 星标

docx

官方

用脚本和 XML 创建、编辑、读取并校验 Word 的 .docx 与 .dotx 文件。

作者 Anthropic197.6k 星标

搭建、重构和排查由 MCP 服务器加 widget 界面组成的 ChatGPT Apps SDK 应用。

作者 OpenAI28.8k 星标

用已发布的设计系统组件、变量和样式,把代码或描述转成完整的 Figma 页面并持续更新。

作者 OpenAI28.8k 星标

把代码库里的设计系统按阶段搬进 Figma,每个阶段停下来等你确认。

作者 OpenAI28.8k 星标

Anthropic 的更多技能

浏览全部技能

用「收集背景 → 逐节打磨 → 读者测试」三个阶段,把零散想法写成一份能给别人看的文档。

作者 Anthropic197.6k 星标

docx

官方

用脚本和 XML 创建、编辑、读取并校验 Word 的 .docx 与 .dotx 文件。

作者 Anthropic197.6k 星标

pptx

官方

用 pptxgenjs 脚本、XML 编辑和校验流程创建、修改和读取 .pptx / .potx 文件。

作者 Anthropic197.6k 星标

xlsx

官方

生成、修改并校验带真实公式的 Excel 工作簿,保证数字格式正确、公式零报错。

作者 Anthropic197.6k 星标

把一句生成艺术需求变成一份算法哲学文稿,外加可直接运行的 p5.js 交互页面。

作者 Anthropic197.6k 星标

从需求梳理到草稿、测试、迭代,帮你把一个 agent skill 做出来并验证效果。

作者 Anthropic197.6k 星标