Noteworthy

Noteworthy is a minimalist Hugo theme for writers and bloggers that turns Markdown content into a fully responsive static site.

What is Noteworthy?

Noteworthy is a minimalist Hugo theme for writers and bloggers, created by kimcc and released under the MIT License. It takes Markdown-based content organized in Hugo page bundles and produces a lightweight, fully responsive static site with RSS feeds, social media links, and optional Disqus comments. The theme is built on the Hugo static site generator and uses SCSS for styling, with zero build-time dependencies beyond Hugo itself.

What makes Noteworthy stand out?

• Fully responsive layout — The theme adapts to mobile, tablet, and desktop viewports out of the box.
• Google Analytics and Disqus integration — Add your Analytics identifier and Disqus shortname in the config.toml file to enable tracking and comments.
• Ko-fi donation button — Optional support button for posts, enabled by setting enableKofi = true and adding your Ko-fi ID in the config.
• KaTeX mathematical notation — Write LaTeX-style math in Markdown and have it rendered in the browser.
• Syntax highlighting — Code blocks are highlighted without requiring a separate JavaScript library.
• Resize-image shortcode — Display large images with optional captions using a built-in shortcode that works with Hugo post bundles.
• Read more links — Set showReadMore = true to show a "read more" link on truncated post excerpts.
• Social media icons — Links for over 20 platforms (GitHub, Twitter, Medium, LinkedIn, etc.) can be configured in the params section.

Who is Noteworthy for?

• Writers and bloggers who want a clean, text-focused site that lets their content stand out without visual clutter.
• Technical bloggers who want to publish code snippets with syntax highlighting and math formulas via KaTeX without extra setup.
• Hugo users looking for a minimal theme that is easy to customize through SCSS and the config.toml file.
• Creators who accept donations can add a Ko-fi button directly to posts.

What can you do with Noteworthy?

• Publish a personal blog: write Markdown posts, set tags and categories, and let Noteworthy generate archive and about pages automatically.
• Add image-heavy posts: use the resize-image shortcode with Hugo page bundles to include optimized images with captions.
• Connect your social presence: configure links to social profiles in the config and icons will appear site-wide.
• Enable comments and analytics: plug in Disqus and Google Analytics identifiers for engagement and traffic measurement.

How does Noteworthy work?

Installation is a two-step process: clone the theme repository into your Hugo site's themes directory, then reference it in your site configuration. To use the resize-image shortcode, create a Hugo post bundle by placing your Markdown file (renamed index.md) and images in a folder; the shortcode then outputs an <img> tag with the caption. All other features are controlled through the config.toml file's params section.

FAQ

Is Noteworthy free to use?

Yes, Noteworthy is open source and released under the MIT License, so you can use, modify, and distribute it freely, including for commercial projects.

Does Noteworthy require JavaScript?

Noteworthy uses no mandatory JavaScript for its core layout; Disqus, Google Analytics, and KaTeX load conditionally when you configure them. Syntax highlighting is done server-side by Hugo.

How do I add a donation button?

Set enableKofi = true in your config and add your Ko-fi identifier to the kofi parameter. The button will then appear on your posts.

Can I remove social media icons I don't need?

Yes, the config file lists all supported social links; delete the lines for the platforms you don't want and their icons disappear from the site.

Does Noteworthy support math equations?

Yes, it integrates KaTeX, so you can write inline and display math in Markdown and have it rendered in the browser.