Search...Search plugins and themes...
⌘K
Sign in
  • Get started
  • Download
  • Pricing
  • Enterprise
  • Account
  • Obsidian
  • Overview
  • Sync
  • Publish
  • Canvas
  • Mobile
  • Web Clipper
  • CLI
  • Learn
  • Help
  • Developers
  • Changelog
  • About
  • Roadmap
  • Blog
  • Resources
  • System status
  • License overview
  • Terms of service
  • Privacy policy
  • Security
  • Community
  • Plugins
  • Themes
  • Discord
  • Forum / 中文论坛
  • Merch store
  • Brand guidelines
Follow us
DiscordTwitterBlueskyThreadsMastodonYouTubeGitHub
© 2026 Obsidian

PDF Page Numbers

David ButlerDavid Butler473 downloads

Adds page numbers to PDF exports (e.g. 'Page 1 of 5').

Add to Obsidian
  • Overview
  • Scorecard
  • Updates3

Adds configurable page numbers to your PDF exports from Obsidian.

Features

  • Automatic page numbering — every page in your exported PDF gets a number
  • Built into the native export flow — adds a page-number toggle to Obsidian's PDF export dialog
  • Multiple positions — bottom-center, bottom-left, bottom-right, top-center, top-left, top-right
  • Flexible formats — "1", "Page 1 of 5", or a custom template
  • Skip first page — optionally hide the number on page 1 (title pages)
  • Configurable style — font size, color, and margins

Requirements

  • Obsidian desktop 1.12.4 or newer

Installation

Manual

  1. Download main.js, manifest.json, and styles.css from the latest release
  2. Create a folder your-vault/.obsidian/plugins/pdf-page-numbers/
  3. Copy the three files into that folder
  4. Enable the plugin in Settings → Community Plugins

From source

cd obsidian-pdf-page-numbers
npm install
npm run build

Then copy main.js, manifest.json, and styles.css into your vault's plugin folder.

Usage

  1. Open a note
  2. Choose Export to PDF
  3. Enable or disable Page numbers in the export dialog
  4. Export the PDF

Settings

Setting Description Default
Enable page numbers Turn page numbers on or off On
Position Where on the page Bottom Center
Format Number format Page X of Y
Custom format Template with {{page}} and {{total}} Page {{page}} of {{total}}
Font size Size in points 10
Font family Font used for page numbers sans-serif
Color Hex color #666666
Skip first page Hide number on page 1 Off
Bottom margin Pixels from bottom edge 20
Top margin Pixels from top edge 20
Side margin Pixels from left/right edge 20

How It Works

Obsidian 1.12.4 exports PDFs from a hidden popup window rather than the main note view. This plugin patches that popup's print flow so it can inject page-number header/footer options at export time.

The plugin also keeps a DOM-based fallback for Obsidian print views, but the primary path is the hidden export popup used by the built-in PDF dialog.

License

MIT

HealthGood
ReviewCaution
About
Add configurable page numbers to PDFs exported from Obsidian. Choose position (top/bottom, left/center/right), pick a format or custom template, skip the first page, and set font, color, and margins from the export dialog.
PDFExportFormatting
Details
Current version
1.0.2
Last updated
6 months ago
Created
6 months ago
Updates
3 releases
Downloads
473
Compatible with
Obsidian 1.12.4+
Platforms
Desktop only
License
MIT
Report bugRequest featureReport plugin
Author
David ButlerDavid Butlerdwbutler
divergentsystems.ai
GitHubdwbutler
  1. Community
  2. Plugins
  3. PDF
  4. PDF Page Numbers

Related plugins

Advanced PDF Export

Export notes as pixel-perfect PDFs with live preview, style presets, manual page breaks, tables, and full layout control.

Slides Extended

Create markdown-based reveal.js presentations. Fork of Advanced Slides.

Pandoc Plugin

Commands to export to Pandoc-supported formats like DOCX, ePub and PDF.

qmd as md

Edit, preview, and render Quarto (.qmd) files with executable code cells via Quarto to PDF, DOCX, HTML, or reveal.js.

Heading Level Indent

Indenting content under headers based on their level.

Marp Slides

Create Marp presentations.

PDF Highlights

Extract highlights, underlines and annotations from your PDFs.

Linter

Format and style your notes. Linter can be used to format YAML tags, aliases, arrays, and metadata; footnotes; headings; spacing; math blocks; regular Markdown contents like list, italics, and bold styles; and more with the use of custom rule options.

Karpathy LLM Wiki

Karpathy's LLM Wiki implementation plugin for Obsidian - turns notes and PDFs into a linked, LLM-powered knowledge base with entity pages, concept pages, graph-powered Q&A, and local-first privacy.

Admonition

Admonition block-styled content.