单栏长文布局，首页、归档、分类、标签共用同一栏宽
Hugo博客
hugo-blog-tuan — Hugo 博客模板
作者 chidokun
面向长文写作的 Hugo 单栏主题，构建期渲染 KaTeX 与 Chroma，支持日文注音与越南语。
看看你的网站会是什么样
浏览真实页面截图，比较内容排版与手机效果。点击下方缩略图切换，放大查看整页细节。
全部页面与视图 3
截图用于了解视觉与布局，交互效果请以实际项目为准。 本截图因高度限制未包含整页。
采集于 2026-09-27查看来源
值得关注的模板亮点
从已有项目资料中，快速了解它的特点。
KaTeX 公式与 Chroma 代码高亮均在构建时渲染，不依赖客户端脚本
Mermaid 图表从主题取色，主题切换时自动重绘
日文注音与着重号、越南语拼音字符支持
明暗模式跟随系统，切换无闪烁
颜色、字号、栏宽以 CSS 变量集中定义，可用 custom.css 覆盖
模板详细介绍
blog@tuan 是一个为长文写作准备的 Hugo 主题，结构上只保留一栏正文，配色是克制的冷灰色，正文用 Georgia 衬线字体，界面文字走系统字体，只有代码用的 Space Mono 需要下载。首页、归档、分类、标签四个视图共用同一栏宽，页面之间切换不会出现宽度跳动。数学公式和代码高亮都在构建阶段完成，页面加载时已经是最终形态，不依赖客户端重排。
主题对写作场景的处理比较细：KaTeX 与 Chroma 在构建时渲染，Mermaid 图表会跟随主题取色并在切换时重绘；支持日文的注音（ruby）和着重号（kenten），越南语拼音字符也在字体覆盖范围内。阅读时长、目录、复制代码按钮、RSS、sitemap、Open Graph、JSON-LD 都已包含。适合以文字为主、需要公式或代码示例的个人博客、技术笔记和文档型站点。
需要注意几点：主题要求 Hugo 0.141.0 或更新版本，但不需要 extended 构建；Hugo 不会合并主题的 [markup] 配置，必须手动把 exampleSite/hugo.toml 中的该段复制到自己的配置文件，否则公式、Markdown 属性和跟随主题的代码配色都不会生效。仓库未标注星标，许可证状态显示为 review，正式使用前建议核对 LICENSE 与维护状态。主题不支持竖排书写。
Hugo博客
适合你的项目吗？
适用场景
- 以文字为主、篇幅较长的个人博客
- 需要展示数学公式或代码片段的技术笔记
- 面向日文或越南语读者的写作站点
- 希望减少客户端 JavaScript 依赖的静态站点
适合人群
- 使用 Hugo 且版本不低于 0.141.0 的站点
- 接受手动复制 [markup] 配置的维护者
- 偏好单栏阅读体验、不需要侧边栏或复杂首页的写作者
上手与定制指南
结合仓库当前版本的说明，按下面的资料检查内容、配置与运行要求。
- 1
Hugo 需为 0.141.0 或更新版本，extended 构建非必需
- 2
必须把 exampleSite/hugo.toml 中的 [markup] 段复制到自己的配置，否则公式、Markdown 属性与主题化代码配色不生效
- 3
自定义参数须放在 [params] 下，Hugo 会静默丢弃其他位置的键
- 4
日期格式跟随 locale 而非 defaultContentLanguage
- 5
noClasses 需保持 false，否则 Chroma 会把颜色写死、语法高亮不再跟随主题
授权与来源资料
使用条件与限制
免费使用 · 保留许可声明MIT许可，允许免费使用、修改、分发和商用，仅需保留版权与许可声明。README中字体与配置说明属技术建议，非授权限制。
使用时需要遵守
- 保留原作者版权声明和 MIT 许可证声明。
- 保留版权声明和许可声明于所有副本或实质性部分
额外费用与待核对事项
- README未说明截图中字体（如Georgia、Space Mono）的独立授权情况
查看原文依据
Permission is hereby granted, free of charge, to any person obtaining a copy
许可证原文
The above copyright notice and this permission notice shall be included in all
许可证原文
https://github.com/chidokun/hugo-blog-tuan/blob/main/LICENSEhttps://github.com/chidokun/hugo-blog-tuan/blob/HEAD/README.mdPermission is hereby granted, free of char
许可证原文
DeepSeek 根据仓库许可证和 README 整理 ·2026-09-24。结果仅覆盖已读取资料，依赖、图片、字体及后续条款变更以各自原文为准。
项目核对记录与介绍依据
模板资料
- 来源平台
- GitHub
- 资料与维护参考分
- 资料一般 · 74 / 100
- 技术栈
- Hugo
- 网站类型
- 博客
这个分数如何计算
本站按许可资料（最高30分）、演示链接（12分）、预览图（10分）、Star数（15分）、记录的维护时间（15分）、描述完整度（8分）、功能记录（5分）和分类资料（5分）计算。它不是代码、安全或性能测试，也不是 Google 评分；有链接不代表已实测可用。
这个项目需要核对什么
- 记录的仓库更新时间
- 2026-08-26
- 截图检查日期
- 2026-09-07
已收录演示链接。请用你的内容与屏幕尺寸检查；有演示不代表表单、认证或支付已经可用。
目录记录的主要技术栈是 Hugo。请通过依赖清单和锁文件核对实际版本与托管要求。这些说明基于收录资料，不代表代码审计或部署实测。
查看具体选型方法 →介绍的制作与核对状态
介绍由 AI 辅助整理目录与仓库资料。仓库作者不等于这篇介绍的审核者。
当前版本没有可核对的编辑审核记录；旧的应用时间不代表已完成事实审核。
这条历史介绍未保存固定版本的来源快照。请对照当前仓库，发现不一致可反馈。
反馈内容错误看看同类模板
对比同技术栈与用途的模板，找到更适合的视觉与内容结构。
hugo-PaperMod
PaperMod 是 Hugo 生态里知名度较高的主题之一，定位很明确：给博客和轻量作品集站点提供一套干净、响应式的阅读界面。
Hugo · 作品集
LoveIt
❤️A clean, elegant but advanced blog theme for Hugo 一个简洁、优雅且高效的 Hugo 主题
Hugo · 博客
hugo-coder
A minimalist blog theme for hugo.
Hugo · 博客
blowfish
Personal Website & Blog Theme for Hugo
Hugo · 博客
hugo-paper
🪺 A simple, clean, customizable Hugo theme
Hugo · 博客
hextra
Hextra 是一个 Hugo 主题，定位在文档站与博客之间：既提供侧边栏导航、目录、面包屑、分页这类文档站结构，也能承载博客内容。
Hugo · 文档