🔍 现象

  • TOC（目录）中 所有一级标题没有跳转
  • 查看渲染后的 HTML，发现 H1 标签 没有 id 属性
  • 目录里的 <a> 也就没有 href，自然无法跳转

🎯 根本原因

Hexo 在默认的渲染器（marked）里，不会给 H1 自动生成锚点 ID。

原因是它将 H1 默认视为文章标题，而不是内容结构的一部分，所以不参与目录锚点生成。

➡ 结果：H1 没有 ID → TOC 无法跳转。

✅ 解决方案（最推荐）

正文中的一级标题改为二级标题。

1
# 功能介绍

改为：

1
## 功能介绍

✨ 额外优化：Anchor 配置建议

Butterfly 提供了滚动锚点的小功能，推荐保持开启：

1
2
3
anchor:
  auto_update: true
  click_to_scroll: true

  • auto_update：滚动时自动更新 URL 中的锚点

  • click_to_scroll：点击标题时能平滑跳转到对应位置

体验会更顺滑。