---
name: pdf2md 用法
description: PDF 转 Markdown 工具用法备忘，包括命令、参数、已知限制
type: reference
originSessionId: f1461373-2a42-4aa6-a186-df9af265c034
---
# pdf2md 工具用法

## 快速使用

```bash
# 基本转换
/workspace/scripts/pdf2md.sh input.pdf

# 指定输出
/workspace/scripts/pdf2md.sh input.pdf -o output.md

# 页码范围
/workspace/scripts/pdf2md.sh input.pdf -f 1 -l 10

# 原始文本（跳过后处理）
/workspace/scripts/pdf2md.sh input.pdf --raw

# 输出到 stdout
/workspace/scripts/pdf2md.sh input.pdf -o -
```

## 触发方式

- Claude Code Skill: `/isos-pdf2md <path>`
- 命令行: `/workspace/scripts/pdf2md.sh`
- Skill 文件: `.claude/skills/isos-pdf2md/SKILL.md`

## 依赖

- `poppler-utils`（提供 `pdftotext`）

## 已知限制

- 不支持扫描件/图片型 PDF
- 复杂表格识别有限
- 多栏布局可能交错
- 不提取图片