Modified from the Hugo PaperMod theme, with the repository released under the MIT license
sulv-hugo-papermod — Hugo Portfolio Template
By xyming108
A blog theme modified from Hugo PaperMod, released under the MIT license, with a demo site and site-building tutorial links.
Explore the design
Compare the page layouts and mobile experience. Open any screenshot for a closer look.
Actual screenshot captured by the server browser.
All pages & views 3
Screenshots show visual appearance; interactive behavior may differ.
What stands out
A quick read of the recorded project description.
Provides an online demo site, with screenshots of desktop, mobile, and inner pages
Includes built-in shortcodes such as bilibili, youtube, ppt, douban, innerlink, and gallery
Includes the official themes/hugo-PaperMod theme via a git submodule
The README includes the author's site-building tutorial link and notes on handling common issues
Template Details
sulv-hugo-papermod is a blog theme modified by the blogger from the Hugo PaperMod theme. The repository is released under the MIT license, and the author's personal website https://www.sulvblog.cn uses this theme. The project provides an online demo (https://xyming108.github.io/), with actual screenshots of the desktop and mobile homepages and article list pages available for reference.
The theme uses Hugo as its build tool. The repository includes the official theme under themes/hugo-PaperMod via a git submodule, so after pulling the code, the submodule must be initialized separately for the build to work. The README states that local preview uses the command hugo server -D, and the result can be viewed at localhost:1313.
The theme includes several custom shortcodes, including bilibili, youtube, ppt, douban, innerlink (an in-article link card that requires a relative path ending in .md), and gallery (used with figure). The templates contain many personal information fields that users must modify one by one, and the author provides a site-building tutorial link for reference. The README also documents a line-ending conversion issue that may occur when deploying to GitHub and the corresponding command to handle it.
Is it right for your project?
Use Cases
- Building a personal blog site
- Serving as a starting point for secondary modifications to a Hugo blog theme
- Embedding videos, PPTs, Douban entries, or galleries in articles
- Evaluating the theme's page layout by referring to the demo site
Suitable For
- Developers who build blogs with Hugo
- Users who want to make personalized adjustments based on PaperMod
- Blog authors who need Chinese site-building tutorials and shortcode examples
Getting started & customization
Use these recorded setup notes alongside the repository instructions for your chosen version.
- 1
After git clone, run git submodule update --init to pull the themes/hugo-PaperMod submodule
- 2
Run hugo server -D in the project directory and visit localhost:1313 in a browser to preview
- 3
The templates contain many personal information fields that must be modified one by one according to the site-building tutorial provided by the author
- 4
If an LF/CRLF line-ending warning appears when deploying to GitHub, run git config core.autocrlf false
- 5
Third-party assets such as demo images, fonts, and icons must be checked separately under their respective licenses
License & source material
Usage conditions & limitations
Free to use · keep license noticeThis entry covers the free version in the public repository under the MIT license; the free scope is the code of this version and does not mean that external services or third-party assets are free.
Must comply with when using
- Free use, modification, commercial use, and distribution of this version's code are permitted.
- When distributing copies or substantial portions of the code, retain the original author's copyright notice and the complete MIT license notice.
- The code is provided as is; warranties and limitations of liability are governed by the original license and applicable law.
Additional costs & items to verify
- This theme is a derivative work modified from the Hugo PaperMod theme, and use requires compliance with the license terms of the upstream PaperMod theme as well.
- The repository includes the official themes/hugo-PaperMod theme via a git submodule, so after cloning, git submodule update --init must be run for the build to work.
- The templates contain many of the author's personal information fields, and users must modify them one by one before using the theme for their own site.
- The configuration instructions depend on the author's site-building tutorial on an external website; that tutorial is an off-site resource and its availability is not controlled by this repository.
- The innerlink shortcode can only use a relative path, and the path must end with .md; otherwise, the in-article link card cannot be generated correctly.
- Demo images, fonts, icons, and other third-party assets must be checked under their respective licenses and cannot be judged solely by the code's MIT license.
- External services such as domains, hosting, databases, payments, or AI may incur separate charges.
View Original Text Basis
Permission is hereby granted, free of charge
Original License Text
该主题根据Hugo PaperMod主题修改而来
Original README
输入`git submodule update --init`,表示拉取themes/hugo-PaperMod/下的子模块
Original README
模板内部有许多个人信息需要自己配置,请耐心修改完
Original README
可以参考博主的建站教程:[https://www.sulvblog.cn/posts/blog/](https://www.sulvblog.cn/posts/blog/)
Original README
https://github.com/xyming108/sulv-hugo-papermod/blob/main/LICENSEhttps://github.com/xyming108/sulv-hugo-papermod/blob/main/README.md{{< innerlink src="posts/tech/mysql_1.md" >}}
Original README
Compiled by DeepSeek based on repository license and README ·2026-10-02. Results only cover the materials read; dependencies, images, fonts, and subsequent term changes are subject to their respective original texts.
Project checks & description sources
Template Information
- Source platforms
- GitHub
- Documentation and maintenance reference score
- More documented · 81 / 100
- Technologies
- Hugo · HTML
- Website type
- Portfolio · Blog
How this score is calculated
Our heuristic uses license records (up to 30), a demo link (12), a preview (10), stars (15), recorded maintenance (15), description completeness (8), feature records (5) and classification data (5). It is not a code, security or performance test, or a Google score. A link does not establish tested functionality.
What to verify for this project
- Repository update recorded
- 2024-02-22
- Screenshot last checked
- 2026-10-02
A demo link is listed. Check it with your own content and viewport sizes; its presence does not confirm that forms, authentication or payments work.
The catalog identifies Hugo as the primary stack. Check the actual dependency manifest and lockfile for versions and hosting requirements. These notes use recorded metadata, not a code audit or a deployment test.
Use a selection guide →How this description was prepared
AI-assisted description based on catalog records and repository material. Repository authors are not automatically the reviewers of this description.
Automatically checked against source and license rules; no manual editorial review.
Inspect the recorded source material
SHA-256: e9a39632d1a375cad7471cee56fd5203c9781534faf1f8f142b37a75f9e2d537
2026-10-02T16:21:30.301Z
Source file / repository语言:中文 | [English](https://github.com/xyming108/sulv-hugo-papermod/blob/main/static/README_EN.md)
> 该主题根据Hugo PaperMod主题修改而来: https://github.com/adityatelange/hugo-PaperMod
### [博客DEMO](https://xyming108.github.io/)
## 1. git clone 拉取代码
① 用`git clone`的方式拉取代码至桌面,此时会在桌面生成sulv-hugo-papermod目录
② 进入到sulv-hugo-papermod目录,输入`git submodule update --init`,表示拉取themes/hugo-PaperMod/下的子模块,里面放的是官方主题
## 2. 启动界面
③ 把目录定位到sulv-hugo-papermod下,在终端输入`hugo server -D`,在浏览器输入:localhost:1313 即可看到现成的博客模板。
## 3. 修改信息
模板内部有许多个人信息需要自己配置,请耐心修改完,可以参考博主的建站教程:[https://www.sulvblog.cn/posts/blog/](https://www.sulvblog.cn/posts/blog/)
## 4. Hugo博客交流群
🎉🎉 787018782 🎉🎉
## 5. shortcodes使用方法
`bilibili: {{< bilibili BV1Fh411e7ZH(填 bvid) >}}`
`youtube: {{< youtube w7Ft2ymGmfc >}}`
`ppt: {{< ppt src="网址" >}}`
`douban: {{< douban src="网址" >}}`
```
# 文章内链卡片
# 末尾要加 md,只能填写相对路径,如下
{{< innerlink src="posts/tech/mysql_1.md" >}}
```
```
gallery:
{{< gallery >}}
{{< figure src="https://www.sulvblog.cn/posts/read/structural_thinking/0.png" >}}
{{< figure src="https://www.sulvblog.cn/posts/read/structural_thinking/0.png" >}}
{{< /gallery >}}
```
## 5. 可能遇到的问题
1. 有些使用者会部署到github,可能遇到跨系统的问题,如提示`LF will be replaced by CRLF in ******`,这时输入命令:`git config core.autocrlf false`,解决换行符自动转换的问题。Explore similar templates
Compare previews and descriptions within the same stack and category.

hugo-PaperMod
A fast, clean, responsive Hugo theme for blogs and lightweight portfolios, with three layout modes (Regular, Home-Info, Profile), automatic and manual light/dark themes, Fuse.js client-side search, multilingual support, and built-in Open Graph, Twitter Cards, and Schema.org data.
Hugo · Portfolio

LoveIt
LoveIt is a clean, elegant, and feature-rich Hugo blog theme derived from LeaveIt and KeepIt, MIT-licensed. It offers light/dark modes, responsive layout, multilingual support, and search via Lunr.js or Algolia.
Hugo · Blog

hugo-coder
hugo-coder is a minimalist Hugo blog theme maintained by luizdepra under the MIT license. It provides a clean, text-focused blog appearance, configuration documentation in the docs directory, and a complete exampleSite with hugo.toml.
Hugo · Blog

blowfish
Blowfish is a Hugo personal website and blog theme built with Tailwind CSS 4, focused on lightness, simplicity, and content-first presentation.
Hugo · Blog

hugo-paper
hugo-paper is a simple, clean, and customizable Hugo blog theme configured through config.toml or hugo.toml.
Hugo · Blog

hextra
Hextra is a Hugo theme for documentation and blog sites, built on Hugo and Tailwind CSS with design referencing Nextra.
Hugo · Documentation
