# hugo-theme-academic-cv: A Hugo Academic Portfolio for Researchers and Faculty

> hugo-theme-academic-cv is a free MIT-licensed Hugo template from the HugoBlox project that turns Markdown files and BibTeX references into a hosted academic portfolio. It targets researchers, PhD students, and faculty who want a citable online presence with auto-imported publications and free hosting on static platforms.

**HugoBlox/hugo-theme-academic-cv** — Academic portfolio that boosts citations. AI generates pages, you own as Markdown. BibTeX auto-import, Jupyter, LaTeX, slides, visual block editor, free to host forever. 学术主页，AI 生成，Markdown 拥有.

- Repository: https://github.com/HugoBlox/hugo-theme-academic-cv
- Website: https://hugoblox.com/templates/academic-cv
- Stars: 5,072 · Forks: 6,442
- Language: Jupyter Notebook
- License: MIT
- Published: 2026-08-08 · Updated: 2026-08-18 · Language: en
- Canonical page: https://hysenlabs.com/projects/hugoblox-hugo-theme-academic-cv

## What hugo-theme-academic-cv Is and Who It Serves

hugo-theme-academic-cv is a Hugo static site template packaged by the HugoBlox project. It is aimed at four overlapping groups: students and recent graduates building a portfolio for lab or industry applications; researchers who want a citable online presence with publications, talks, and projects in one place; faculty and principal investigators presenting a lab with group news and team member profiles; and anyone with a publication list who wants auto-generated citation pages from a BibTeX file without manual formatting.

The template stores all content as Markdown files in the content/ directory. A Hugo build turns those files into a static site that can be hosted on GitHub Pages, Netlify, Vercel, or Cloudflare with no server-side runtime. The README describes this as owning the content as plain files with no lock-in, which means moving to a different static site generator or hosting provider involves only the Markdown and asset files.

The template has been part of the HugoBlox ecosystem, previously known as Wowchemy, since 2016. The RELATED SEARCHES for this project frequently include the term "Hugo Academic Wowchemy," reflecting that the template was widely known under that earlier branding.

## Deploying and Running the Site Locally

The fastest path to a live site is through the HugoBlox deploy flow at hugoblox.com/templates/academic-cv, which requires no local software. For a local development workflow, the README provides a CLI command:

```bash
npx hugoblox create site --template academic-cv
```

This requires Hugo Extended and Node.js. The repository uses pnpm as the package manager at version 10.14.0, specified in package.json. Once the site is created, start the development server with:

```bash
hugo server --disableFastRender
```

This starts Hugo's built-in development server with live reload. Changes to Markdown content and configuration files appear in the browser without a full rebuild.

To build the final static output:

```bash
hugo --minify && pnpm run pagefind
```

The pagefind step runs after the Hugo build to generate a client-side search index for the published site. The output goes to the public/ directory and is ready to deploy to any static hosting service.

The go.mod file specifies three HugoBlox kit modules as dependencies: the integrations/netlify module, the blox module for page blocks, and the slides module for presentation pages.

## BibTeX Import, Jupyter Notebooks, and the Content Pipeline

The most specific feature for academic users is BibTeX and DOI auto-import. The README describes dropping a .bib file into the repository and receiving automatically generated publication pages with correct citation formatting. The site then becomes a citable URL for each paper, which Google Scholar can link back to from a publication record.

Jupyter and RMarkdown notebooks are published as blog posts or project pages. A .ipynb file is included in the content directory, and the Hugo build renders the code, outputs, and narrative together. The README states that code, outputs, and narrative remain intact in the rendered page.

LaTeX math notation renders natively. The README lists this as a feature for equations and technical writing, which covers the typical use case for theory papers and mathematical descriptions.

Markdown slides use reveal.js and support math, syntax highlighting, diagrams, and speaker notes. Each slide deck is a Markdown file in the content/slides/ directory.

The content model is flat Markdown files in content/ with front matter for metadata. The config/ directory holds site-level configuration. The assets/ and data/ directories hold images and structured data used in page blocks. This structure is standard Hugo and does not deviate from the framework's conventions, so anyone familiar with Hugo's content model will find it straightforward.

## AI Customization with Hugo Chat and Visual Editing with Ownable CMS

The README describes two tools for customizing the site without writing Hugo templates. Hugo Chat is a separate service at hugo.chat where a user can describe in plain English what page to create, and it generates the structured Markdown with the correct front matter, shortcodes, and content blocks for this template. The README gives the example of requesting a publications page from a BibTeX file.

Ownable CMS is a VS Code extension that provides drag-and-drop editing for the page blocks used by this template. The README describes it as a visual editor that works inside VS Code without requiring knowledge of Hugo's template syntax. The install instruction is to add the Ownable extension from the VS Code marketplace and open the project.

Both tools are optional. The site can be built and maintained entirely through Markdown files and front matter without using either. Hugo Chat and Ownable CMS lower the barrier for users who prefer not to write YAML front matter or edit configuration files manually.

## Where hugo-theme-academic-cv Does Not Fit

The template generates a static site. It has no server-side runtime, no user authentication, no comment system built in, and no dynamic database queries. A researcher who needs a members-only section, a form that submits to a database, or real-time content updates will need to add those capabilities through third-party services, which is not a standard part of this template.

The README notes that a premium tier, Academic CV Pro, includes additional designs, advanced timeline layouts, and full-featured course sections not available in the free version. The comparison table in the README shows that priority support is a Pro feature and the free version receives community support only. A researcher who needs guaranteed response times for deployment issues would need the Pro tier.

The build process requires Hugo Extended, pnpm, and Node.js. A user on a managed university server without local toolchain access cannot build the site locally and would need to rely on the cloud deploy option or a CI pipeline.

The pagefind search runs client-side after the build. There is no server-side search index. For a site with hundreds of publications, the client-side search will load the full index in the browser, which may add perceptible latency on slow connections.

## Comparing with WordPress Academic Themes

WordPress is the most common alternative hosting platform for academic websites. It provides server-side PHP rendering, a plugin ecosystem with comment systems and event calendars, and a visual editor without requiring any knowledge of static site generators. The difference in approach is infrastructure: WordPress requires a hosting environment that runs PHP and a database, which adds cost and maintenance overhead.

huge-theme-academic-cv generates static files that serve from a CDN without a database or PHP runtime. This eliminates the attack surface associated with a PHP application and removes the monthly cost of a managed PHP host. The tradeoff is that dynamic features require third-party services and the build toolchain must be available when updating content.

For an academic user whose primary needs are publication pages and a biography, the static approach is simpler to maintain at scale. For a lab that needs a booking system, member authentication, or live event registration, WordPress's plugin ecosystem provides those capabilities without custom integration.

## Maintenance, License, and the Premium Tier

The last push to the repository was on 2026-09-20. The repository is released under the MIT license, which permits commercial use, modification, and redistribution with attribution.

The README presents Academic CV Pro and Resume Pro as paid tiers at hugoblox.com/pricing. The free version removes attribution in the Pro tier. The README does not document any expiration or subscription model for the free template itself.

The repository has no GitHub releases. The go.mod file pins the HugoBlox kit module versions to specific commits rather than tagged releases, which means module updates happen through commit references rather than version bumps.

## Conclusion

hugo-theme-academic-cv is a practical choice for a researcher who wants publications auto-imported from a BibTeX file, a static site that costs nothing to host, and editable Markdown content without database dependencies. It is not a good fit for someone who needs a full content management system with user accounts, dynamic search, or server-side logic. Before deploying, check that the Hugo Extended version and pnpm are available in the local environment, and decide whether the free tier or Academic CV Pro meets your publication and layout requirements.

## FAQ

### Does hugo-theme-academic-cv require knowing Hugo to use it?

The README says no knowledge of Hugo is required for editing content visually or writing Markdown. Hugo is described as the engine under the hood. The Ownable CMS extension for VS Code provides drag-and-drop editing, and Hugo Chat can generate structured pages from plain-language descriptions.

### How does hugo-theme-academic-cv import publications from BibTeX?

The README describes dropping a .bib file into the repository, after which the build generates publication pages automatically with correct citation formatting. Each page becomes a citable URL that Google Scholar can link to.

### What is the difference between the free hugo-theme-academic-cv and Academic CV Pro?

The README lists premium designs, advanced timeline and layout options, full-featured course sections, attribution removal, and priority support as Pro-only features. The free version uses standard section layouts and receives community support.

## Sources

- [Official documentation](https://hugoblox.com/templates/academic-cv)
- [Official README](https://github.com/HugoBlox/hugo-theme-academic-cv#readme)
- [Project repository](https://github.com/HugoBlox/hugo-theme-academic-cv)

---

Hysen Labs editorial analysis, written from the project's own repository and release notes. Cite the canonical page: https://hysenlabs.com/projects/hugoblox-hugo-theme-academic-cv