The Hugo Second Brain Theme is a free, open-source Hugo starter template for building a future-proof second brain — a personal knowledge base and digital garden — from plain Markdown notes.
What is the Hugo Second Brain Theme?
The Hugo Second Brain Theme is a starter template from HugoBlox (formerly Wowchemy) that turns a folder of Markdown files into a static website for personal notes, knowledge bases, and digital gardens. It takes Markdown notes as input and produces a deployable Hugo site, with optional editing through the integrated Wowchemy CMS. The template is designed to follow the Zettelkasten method (卡片盒笔记法) and supports the Obsidian workflow, making it a bridge between local note-taking apps and a public website.
Key Features
- Markdown-first storage — All notes live in future-proof Markdown files, so your data stays portable and can be edited in Obsidian, Visual Studio Code, or directly on GitHub.
- Rich content rendering — Notes support audio, video, images, math, code, Mermaid diagrams, and more, using Hugo shortcodes and the Wowchemy Markdown/LaTeX pipeline.
- Wowchemy website builder and CMS — The integrated builder lets you edit the site through a CMS or any Git-connected editor, then generates it with Hugo.
- Deployment to GitHub or Netlify — The generated static site can be published to GitHub or Netlify without maintaining a server, and the demo claims setup in under 10 minutes.
- Customizable design — Use widgets to rearrange page layouts, switch between light and dark themes, and apply language packs for multilingual sites.
- Citation import — The Hugo Academic CLI automatically imports BibTeX citations into your notes, useful for researchers.
- Free and open source — The theme is free to use, with documentation, an update guide, and release notes available on GitHub.
Who is it for?
- Students and researchers who want to organize lecture notes, literature, and BibTeX citations in a searchable knowledge base.
- Writers and bloggers building a digital garden of interlinked ideas, published as a clean static site.
- Developers who prefer editing Markdown in Obsidian or VS Code and deploying via Git and Netlify.
- Knowledge workers who want to own their data in plain text while still having a public or private website.
What can you do with the Hugo Second Brain Theme?
- Personal second brain: Collect and link your notes in Markdown, then publish them as a navigable website.
- Knowledge base or documentation: Use the same Markdown source to publish internal or public documentation with rich media and diagrams.
- Digital garden: Create an evolving, public collection of thoughts and resources, updated through Git.
- Research notebook: Import BibTeX citations and combine them with your own commentary and Mermaid diagrams.
How does the template work?
You write Markdown notes locally or on GitHub, optionally edit them through the Wowchemy CMS, and Hugo generates the static site. The template provides pre-configured layouts, so the first site can be published in under 10 minutes, as stated in the template's demo. Deployment is handled by connecting the repository to GitHub or Netlify.
FAQ
Is the Hugo Second Brain Theme free?
Yes, the theme is free and open source. The project accepts GitHub sponsorship to support ongoing development, offering perks such as exclusive academic templates and widgets.
Can I use Obsidian with this theme?
Yes, because all content is stored as plain Markdown, you can open the same repository in Obsidian, edit notes with backlinks, and sync changes to your website through Git.
What does the template support besides text?
Notes can embed audio, video, images, mathematical formulas, code blocks, and Mermaid diagrams. The Wowchemy documentation covers the full Markdown and LaTeX syntax available.
How do I update the theme?
The project provides an Update Guide and Release Notes on GitHub, linked from the template's README.
What do I need to run it?
You need Hugo and Git, plus an account on GitHub or Netlify for deployment. The Wowchemy builder handles the site generation after you edit Markdown.
