快捷菜单
常用功能一站直达
更多功能请点顶栏「快捷菜单」
Hextra 是目前 Hugo 生态里,颜值、现代感、易用性、文档+博客双能力最强的主题之一,非常适合做个人文档库/技术博客。 我直接把 Hextra vs Book vs Docsy 做清晰对比,你一看就知道怎么选。
Hextra
Book
Docsy
| 特性 | Hextra | Book | Docsy |
|---|---|---|---|
| 适合场景 | 个人文档 + 技术博客(全能) | 纯文档、笔记 | 大型项目/企业文档 |
| 安装难度 | 极低(零依赖) | 低 | 高(需Node/npm) |
| 搜索 | ✅ 内置FlexSearch全文搜索 | ✅ 简单 | ✅ 强 |
| 暗黑模式 | ✅ 完美、自动切换 | ✅ 基础 | ✅ 支持 |
| Tailwind CSS | ✅ 是(现代易改) | ❌ 老式CSS | ❌ SCSS复杂 |
| 博客功能 | ✅ 强(分页、标签、分类) | ✅ 弱 | ✅ 支持但笨重 |
| LaTeX/图表 | ✅ 原生支持 | ❌ 需插件 | ✅ 支持 |
| 维护活跃度 | ✅ 极高(2026活跃) | ✅ 一般 | ✅ 高(Google系) |
Hextra
assets/css/custom.css 直接写Book
Docsy
1baseURL = "https://your-domain.com/"
2languageCode = "zh-CN"
3title = "我的个人文档库"
4theme = "hextra"
5
6# 内容
7[params]
8 # 网站信息
9 name = "你的名字"
10 description = "技术笔记、文档、博客"
11
12 # 外观
13 hideFooter = false
14 hideSidebar = false
15 enableDarkMode = true # 开启暗黑
16 autoSwitchTheme = true # 自动切换明暗
17
18 # 搜索
19 enableSearch = true
20
21 # 导航
22 navbarlogo = "/logo.svg" # 可选
23 navbartitle = "文档库"
24
25 # 博客
26 blogdir = "blog"
27 blogsectiontitle = "博客文章"
28
29# 菜单
30[menu]
31 [[menu.main]]
32 name = "📚 文档"
33 url = "/docs/"
34 weight = 1
35 [[menu.main]]
36 name = "✍️ 博客"
37 url = "/blog/"
38 weight = 2
39 [[menu.main]]
40 name = "ℹ️ 关于"
41 url = "/about/"
42 weight = 3
43
44# 语法高亮
45[markup.highlight]
46 codeFences = true
47 guessSyntax = true
48 tabWidth = 4新建 assets/css/custom.css:
1/* 主色调(改成你喜欢的颜色) */
2:root {
3 --primary-hue: 210; /* 蓝色系 */
4 --primary-saturation: 100%;
5}
6
7/* 字体更舒服 */
8.content {
9 font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', 'Microsoft YaHei', sans-serif;
10}
11
12/* 代码块美化 */
13.code-block {
14 border-radius: 8px;
15}Hextra 是目前 Hugo 里颜值+功能+易用性的最佳平衡,最适合个人使用。
要不要我直接给你 Hextra 一键安装+完整目录结构+示例文档+博客模板,你直接复制就能用?
日历 · 精选 · 友链 · 更多
如果内容对你有帮助,欢迎请我喝杯咖啡 ☕



One的公众号
爱折腾博客的小白