Newsletter
Join the Community
Subscribe to our newsletter for the latest news and updates
A plugin that makes your tagged Pinboard bookmarks accessible as a template variable.
The Jekyll Pinboard Plugin is a Ruby gem that loads tagged Pinboard bookmarks into a Jekyll site's template variables during the static site build. It registers a Jekyll Hook that fetches your bookmarks from the Pinboard API and makes them available as the site.pinboard.posts Liquid variable, so you can render them anywhere in your templates.
The Jekyll Pinboard Plugin is an open-source Ruby plugin for Jekyll that connects your Pinboard account to your static site. It reads a Pinboard API token and a list of tags from your _config.yml file, then pulls all matching bookmarks from the Pinboard API at build time. The result is a Liquid-accessible variable containing every bookmark's full metadata, including href, description, extended, meta, hash, time, shared, toread, and tags. The plugin is designed for people who host Jekyll sites and want to publish or repurpose their Pinboard bookmarks without manually copying links.
_config.yml under the pinboard.tags key, and only those bookmarks are loaded.site.pinboard.posts.all, and per-tag collections at site.pinboard.posts.tags.tagname.jekyll serve --watch locally, the Pinboard data does not refresh on content changes, preventing unnecessary API requests.--safe flag, as a registered gem plugin.lib/jekyll-pinboard.rb into your site's _plugins folder for a lazy install.Jekyll site owners who want to feature their Pinboard bookmarks publicly. A developer managing a bookmarks page can keep it synchronized with their Pinboard tags automatically. A portfolio owner can tag projects in Pinboard and have those links appear on a portfolio page. A blogger can surface a reading list or recommended links in a sidebar by iterating over site.pinboard.posts.tags.reading in their layout.
Install the gem by adding gem 'jekyll-pinboard' to your Gemfile and running bundle, then add jekyll-pinboard to your gems: list in _config.yml. Set your Pinboard token from pinboard.in/settings/password and list the tags you want to pull. In any template, access the bookmarks through site.pinboard.posts.all or site.pinboard.posts.tags.tagname and loop over them with Liquid to generate HTML.
No. GitHub Pages does not include this plugin in its supported plugin list. You need to generate your site locally and push the output to host on GitHub.
The token is stored in plain text in your _config.yml, so if you publish your repository or the config file publicly, your Pinboard account credentials are exposed. Keep the file private if you host on GitHub.
Yes. Copy lib/jekyll-pinboard.rb from the repository into your Jekyll site's _plugins directory and the plugin will load automatically.
jekyll serve --watch?No. To avoid gratuitous API calls and slow rebuilds, the Pinboard data is loaded once at startup and is not refreshed as you edit content locally.
