You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

Github Pages如何用jekyll-theme-minimal或易切换主题实现自动目录?

关于Jekyll博客自动生成目录(TOC)的解决方案

能否用jekyll-theme-minimal实现自动TOC?

jekyll-theme-minimal本身没有内置自动生成目录的功能,但你可以通过两种方式手动实现,无需切换主题:

  • 利用Jekyll内置的{% toc %}标签:在你的页面模板文件(比如_layouts/post.html或_layouts/page.html)中添加该标签,同时在需要生成TOC的页面Front Matter里加上toc: true参数。
  • 嵌入JavaScript脚本:在模板中添加一段JS代码,页面加载后自动抓取页面内的h1、h2、h3标签,动态生成目录列表并插入到指定位置,这种方法不需要修改Jekyll配置。

推荐无需大幅修改页面的替代主题

如果不想手动编写代码,以下主题内置自动TOC功能,且与JekyllNow的Markdown语法完全兼容,切换后无需大幅修改现有页面:

  • Minimal Mistakes:支持自动生成TOC,只需在页面Front Matter中添加toc: true即可启用,主题结构与JekyllNow接近,适配Github Pages环境。
  • Just the Docs:主打文档类博客场景,内置侧边栏自动TOC,只要文章使用标准的#、##、###层级标题,就能自动识别生成目录,无需额外修改文章内容。
  • Chirpy:功能完善的博客主题,支持自动TOC功能,开启配置后即可识别文章内的标题层级生成目录,对现有Markdown页面兼容性极佳。

内容的提问来源于stack exchange,提问作者user93353

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.07.13 08:45:03