npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2026 – Pkg Stats / Ryan Hefner

joplin-plugin-pdf-header-footer

v1.0.0

Published

Joplin plugin that adds a configurable header and footer to every page of notes exported to PDF.

Readme

PDF Header & Footer for Joplin

A Joplin plugin that adds a header and footer to every page of a note when you export it to PDF. You set the text in Joplin's settings, so you don't need to edit CSS.

  • Separate left, centre and right text for both the header and the footer
  • Page numbers and the date through placeholders
  • Optional lines under the header and above the footer
  • Adjustable font size and top and bottom page margins
  • The note viewer is unchanged: the header and footer appear only in exported PDFs

Requirements

Joplin desktop 3.2 or later.

Installation

  1. Download plugin.tnoahc.pdf-header-footer.jpl from the latest release.
  2. In Joplin, open Tools → Options → Plugins, click the ⚙ button, and choose Install from file.
  3. Select the downloaded .jpl file and restart Joplin.

Usage

Open Tools → Options → PDF Header & Footer and fill in any of the six text fields:

| Setting | Position on the page | | --- | --- | | Header - left / centre / right | Top margin | | Footer - left / centre / right | Bottom margin |

Leave a field empty to print nothing in that position. You can use these placeholders in any field:

| Placeholder | Replaced with | | --- | --- | | {page} | Current page number | | {pages} | Total number of pages | | {date} | Export date, in your system's date format |

For example, Page {page} of {pages} prints "Page 2 of 5".

Then export a note as usual with File → Export → PDF.

If your custom stylesheet already adds a header or footer, for example with .exported-note::before or ::after, remove those rules so the text doesn't appear twice.

Known limitations

  • File → Print doesn't include the header and footer. Joplin doesn't load plugins when it prints directly. Export to PDF first, then print the PDF.
  • The note title can't be used as a placeholder. Joplin already prints the title at the top of the note.

How it works

The plugin registers a Markdown-it content script. The script adds a CSS @page rule with page margin boxes to the rendered note, built from your settings. Joplin's PDF export prints that rendered HTML, so the header and footer repeat on every page. @page rules only apply when printing, which is why the viewer doesn't change.

Development

The plugin is plain JavaScript in src/, so there's no compile step.

  1. Start Joplin in Development Mode with Joplin --env dev.
  2. In Tools → Options → Plugins → Advanced Settings, set Development plugins to the full path of this repository's src folder.
  3. Restart Joplin. After you edit a file, restart again to reload the plugin.

To build the installable package, run:

sh build.sh      # or: npm run dist

This writes publish/plugin.tnoahc.pdf-header-footer.jpl and the matching .json file that the Joplin plugin repository reads. See RELEASING.md for how to publish a new version.

License

MIT © 2026 Noah C. Tarinyebwa