
Hugo 默认生成的 .TableOfContents 会在最外层 上渲染无意义的列表符号(如圆点),导致目录顶部出现冗余缩进和视觉干扰;本文提供精准 CSS 修复方案,仅移除首层列表标记,保留子级层级符号。
hugo 默认生成的 `.tableofcontents` 会在最外层 `
- ` 上渲染无意义的列表符号(如圆点),导致目录顶部出现冗余缩进和视觉干扰;本文提供精准 css 修复方案,仅移除首层列表标记,保留子级层级符号。
- 移除 #toc 容器内所有
- 的默认列表符号;
- 再显式恢复二级及更深嵌套
- 的圆点样式(即真正承载标题项的列表)。
Hugo 的 {{ .TableOfContents }} 模板函数会自动将 Markdown 标题转换为嵌套
解决方法是通过层级选择器精确重置样式:
/* 移除 TOC 最外层 ul 的圆点 */
#toc ul {
list-style-type: none;
padding-left: 0;
}
/* 仅对嵌套的 ul(即实际标题列表)启用圆点 */
#toc ul ul {
list-style-type: disc;
padding-left: 1.5em;
}
✅ 关键说明:
- #toc ul 匹配所有后代
,包括最外层和所有嵌套层;
- #toc ul ul 是更具体的选择器,优先级更高,能覆盖上一条规则,确保子列表正常显示圆点;
- 添加 padding-left: 0 可消除外层
的默认缩进,进一步提升对齐一致性;
- 若需支持多级标题(如 H3、H4),可扩展为 #toc ul ul, #toc ul ul ul 或直接使用 #toc ul > ul(仅直接子元素),根据主题结构灵活调整。
将上述 CSS 加入你的主题样式文件(如 assets/scss/main.scss 或 static/css/custom.css)并确保正确加载,即可彻底消除多余圆点,同时保持层级语义清晰、视觉层次分明。











