Extract Pages from PDF

The range syntax accepts individual pages and hyphenated spans mixed together in one list — `1-3, 7, 10-12` pulls pages one through three, page seven on its own, and pages ten through twelve, all into a single new document in that order. Pages are always output in the order they are written, not renumbered or sorted, so `10-12, 1-3` produces a document with the later pages first — useful when the extract needs a different order than the source, such as pulling a summary page from the end to the front.

Page numbers refer to the position in the original document as it currently stands, one-indexed, and any page number beyond the end of the document is silently ignored rather than raising an error — asking for pages 1-3 from a two-page document simply returns the two pages that exist.

A single range like `10-12` produces one new document containing those three pages in sequence, which is the right result when the pages belong together — a chapter, a section, a set of related exhibits. Several disconnected ranges specified at once, like `1, 15, 30`, are typically clearer as separate single-page extracts than as one document with unrelated pages jammed together, since a reader opening the combined file would otherwise find page 1 followed abruptly by page 15 with no indication anything was skipped.