SuperAPI AI 工具集

extract-slide-text

办公与效率

查看项目

更新于 10-16 07:49

技能介绍

用途

该技能用于从 PDF 的每一页中提取文本内容,并写入一个结构化的 Markdown 文件。其核心目标是产出幻灯片文本的“基准内容”(ground-truth),供后续阅读、检索或整理使用。

主要能力

运行 extract_slide_text.py 脚本,即可把 PDF 各页文本提取到 Markdown 文件中。输出文件按幻灯片逐页组织,每一页包含一个标题、一条图片引用,以及该页提取出的文本。

输出格式示例:

Slide 1

``` Extracted text content from slide 1 ```

Slide 2

``` Extracted text content from slide 2 ```

对于没有可提取文本的页面(例如整页图片),会显示 (no extractable text)。

使用方式

命令格式:

uv run .agents/skills/extract-slide-text/extract_slide_text.py <pdf_path> <output_path> [images_dir]

参数说明:

  • pdf_path(必填):PDF 文件路径。
  • output_path(必填):输出 Markdown 文件的写入路径。
  • images_dir(可选):幻灯片图片目录路径,用于生成正确的相对图片引用,默认为 slide_images/。

前置条件:需要安装 Poppler 工具(提供 pdftotext 命令)。

  • macOS:brew install poppler
  • Ubuntu:apt-get install poppler-utils

适用场景

适合需要把 PDF 幻灯片批量转为带页码分节、带图片引用的 Markdown 文本的场景,例如整理演示文稿内容、为后续处理准备文本素材。

限制

  • 文本提取依赖 pdftotext,必须预先安装 Poppler;缺失时无法运行。
  • 无文本层的页面(如整页图片)只能得到 (no extractable text),不会产生文本内容。
  • 图片引用依赖 images_dir 指向实际存在的幻灯片图片目录,否则相对路径引用可能不正确。