# Paper Parse

> Parse academic PDF papers into markdown with figure extraction.

- Skill: `dvcrn/paper-parse-2` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add dvcrn/paper-parse-2`
- Raw SKILL.md: https://api.skillmd.com/api/skills/dvcrn/paper-parse-2/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing
- Author: dvcrn (https://skillmd.com/u/dvcrn)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/dvcrn/paper-parse-2

---


# Paper Parse

Parse academic PDF papers into structured markdown with figure extraction using PyMuPDF.

## Usage

```bash
uv run {baseDir}/scripts/parse_paper.py --pdf /path/to/paper.pdf [--output-dir ./output]
```

## Output

The tool generates:

- `{paper_name}_content.md` - Full paper content in markdown
- `{paper_name}_parsed.json` - Structured metadata including:
  - Paper title
  - Number of pages
  - Extracted figures with captions and paths
- `cover_title_authors.png` - First-page snapshot focused on title + authors region
- `figures/` - Directory containing high-resolution figure screenshots

## Example

```bash
uv run scripts/parse_paper.py --pdf ~/papers/my-paper.pdf --output-dir ./parsed
```

Output structure:
```
./parsed/
├── my-paper_content.md
├── my-paper_parsed.json
└── figures/
    ├── figure_1.png
    ├── figure_2.png
    └── ...
```

## Dependencies

- PyMuPDF (fitz) - PDF parsing and rendering
- pymupdf4llm - Markdown conversion

These are automatically managed by uv via the inline script metadata.