[Enhancement] Scope .totalpages to last .resetpagenumber via document|section argument
#596 opened on Jul 14, 2026
Repository metrics
- Stars
- (13,975 stars)
- PR merge metrics
- (Avg merge 1d 6h) (31 merged PRs in 30d)
Description
Before submitting
- I am using the latest version of Quarkdown.
- I have checked the wiki to confirm this feature doesn't already exist.
- I have searched existing issues for duplicates.
Description
I would want .totalpages to also be affected by .resetpagenumber. Consider this scenario where I don't want a numbering on the title page:
.doctype {paged}
.center
#! Title Page
.pagebreak
# First content page
.pagemargin {bottomcenter}
.currentpage / .totalpages
.resetpagenumber
# Second content page
# Third content page
I want the page numbering to range from 1/3 to 3/3. Instead it ranges from 1/4 to 3/4.
Proposed syntax or behavior
A relatively easy and backwards-compatible fix would be to allow .totalpages to have an optional argument being one of document | section with document being the default.
documentwill act as the.totalpages-command just as beforesectionwill be the number of pages starting from either the last.resetpagenumber-command (considering thestartargument there) or the document start
Additional context
This would actually also mimic the behaviour of Microsoft Word, which uses {NUMPAGES} for the total page count of the whole document and {SECTIONPAGES} for the total page count only within the current section.
I am using quakdown version 2.3.1.